agent-channels
Use when working on the channel bindings and carriage profiles surface in @jeswr/agent-channels.
- License 许可
- MIT
- 所属仓库
- jeswr/solid-sdk
- 最近更新
- 2026-11-15
- Stars
- ★ 2
- Forks
- 0
01 前言 Front Matter
- name
- agent-channels
- description
- Use when working on the channel bindings and carriage profiles surface in @jeswr/agent-channels.
02 资源文件 118
- 参考文档docs/hosted-matrix-bridges.md5.4 KB
- 参考文档package.json4.9 KB
- 参考文档README.md42.0 KB
- 脚本src/a2a.ts112 B
- 脚本src/a2a/send.ts112 B
- 脚本src/binding.ts3.1 KB
- 脚本src/bluesky.ts112 B
- 脚本src/bluesky/send.ts112 B
- 脚本src/capability.ts673 B
- 脚本src/channel.ts3.9 KB
- 脚本src/direct.ts4.1 KB
- 脚本src/direct/send.ts6.4 KB
- 脚本src/direct/shared.ts3.1 KB
- 脚本src/discord.ts7.2 KB
- 脚本src/discord/send.ts7.9 KB
- 脚本src/discord/shared.ts1.7 KB
- 脚本src/email-message.ts3.9 KB
- 脚本src/email-mime.ts9.3 KB
- 脚本src/email-mime/send.ts385 B
- 脚本src/email/bodies.ts5.0 KB
- 脚本src/email/mime.ts8.0 KB
- 脚本src/email/render.ts5.6 KB
- 脚本src/envelope.ts4.7 KB
- 脚本src/errors.ts1.7 KB
- 脚本src/github.ts12.3 KB
- 脚本src/gmail.ts7.8 KB
- 脚本src/gmail/errors.ts1.4 KB
- 脚本src/gmail/rest.ts4.4 KB
- 脚本src/gmail/send.ts5.9 KB
- 脚本src/gmail/triage.ts612 B
- 脚本src/graph-mail.ts7.1 KB
- 脚本src/graph-mail/rest.ts4.9 KB
- 脚本src/graph-mail/send.ts8.7 KB
- 脚本src/graph-teams.ts9.2 KB
- 脚本src/graph-teams/card.ts1.9 KB
- 脚本src/graph-teams/rest.ts6.0 KB
- 脚本src/graph-teams/send.ts7.9 KB
- 脚本src/html.ts811 B
- 脚本src/imessage.ts112 B
- 脚本src/imessage/send.ts112 B
- 脚本src/index.ts483 B
- 脚本src/mastodon.ts7.1 KB
- 脚本src/mastodon/entities.ts1.8 KB
- 脚本src/mastodon/named-references.ts52.2 KB
- 脚本src/mastodon/records.ts4.2 KB
- 脚本src/mastodon/rest.ts4.5 KB
- 脚本src/mastodon/send.ts8.0 KB
- 脚本src/matrix.ts15.3 KB
- 脚本src/matrix/bridge.ts2.3 KB
- 脚本src/matrix/crypto.ts1.5 KB
- 脚本src/matrix/send.ts11.9 KB
- 脚本src/matrix/shared.ts3.4 KB
- 脚本src/mcp.ts112 B
- 脚本src/mcp/send.ts112 B
- 脚本src/message.ts6.7 KB
- 脚本src/origins.ts7.7 KB
- 脚本src/profiles.ts3.6 KB
- 脚本src/provider/attempt.ts630 B
- 脚本src/provider/send.ts190 B
- 脚本src/public-http.ts112 B
- 脚本src/public-http/send.ts112 B
- 脚本src/slack.ts112 B
- 脚本src/slack/send.ts112 B
- 脚本src/telegram.ts112 B
- 脚本src/telegram/send.ts112 B
- 脚本src/testing.ts2.3 KB
- 脚本src/testing/send.ts112 B
- 脚本src/types.ts2.4 KB
- 脚本src/x.ts7.0 KB
- 脚本src/x/spend.ts1.8 KB
- 脚本test/contracts.test.ts5.5 KB
- 脚本test/direct.test.ts50.3 KB
- 脚本test/discord-reader.test.ts11.6 KB
- 脚本test/discord-send.test.ts16.7 KB
- 脚本test/email-golden.test.ts3.1 KB
- 脚本test/email.test.ts26.3 KB
- 脚本test/envelope.test.ts4.5 KB
- 脚本test/exports.test.ts7.8 KB
- 其他test/fixtures/direct-capability.ttl883 B
- 其他test/fixtures/discord-capability.ttl1.1 KB
- 参考文档test/fixtures/discord.json876 B
- 参考文档test/fixtures/github-notifications.json687 B
- 参考文档test/fixtures/gmail.json714 B
- 参考文档test/fixtures/graph-mail.json744 B
- 脚本test/fixtures/graph.ts1.6 KB
- 其他test/fixtures/mastodon-capability.ttl917 B
- 参考文档test/fixtures/mastodon.json1.0 KB
- 脚本test/fixtures/matrix-bridges.ts999 B
- 参考文档test/fixtures/matrix-send.json681 B
- 脚本test/fixtures/matrix.ts3.0 KB
- 其他test/fixtures/propose.eml7.2 KB
- 参考文档test/fixtures/propose.json2.0 KB
- 脚本test/fixtures/signed.ts1.8 KB
- 参考文档test/fixtures/teams-card.json1.2 KB
- 脚本test/fixtures/teams.ts1.8 KB
- 参考文档test/fixtures/x.json340 B
- 脚本test/github.test.ts22.4 KB
- 脚本test/gmail.test.ts31.5 KB
- 脚本test/graph-mail-send.test.ts17.5 KB
- 脚本test/graph-mail.test.ts23.9 KB
- 脚本test/graph-teams-rate.test.ts3.3 KB
- 脚本test/graph-teams-send.test.ts18.5 KB
- 脚本test/graph-teams.test.ts16.3 KB
- 脚本test/linkedin.test.ts2.4 KB
- 脚本test/mastodon.test.ts35.6 KB
- 脚本test/matrix-bridges.test.ts16.5 KB
- 脚本test/matrix-crypto.test.ts2.3 KB
- 脚本test/matrix-native.test.ts2.4 KB
- 脚本test/matrix-send.test.ts15.0 KB
- 脚本test/matrix.test.ts24.3 KB
- 脚本test/mime.test.ts4.7 KB
- 脚本test/origins.test.ts31.4 KB
- 脚本test/provider-attempt.test.ts1.2 KB
- 脚本test/send-authority.test.ts7.9 KB
- 脚本test/x.test.ts11.9 KB
- 参考文档tsconfig.json212 B
- 参考文档tsconfig.test.json283 B
- 脚本vitest.config.ts427 B
03 SKILL.md 正文
<!-- AUTHORED-BY Codex GPT-6.1-Sol --> <!-- AUTHORED-BY Codex GPT-6 -->
@jeswr/agent-channels
Read agent DESIGN §2–3 and the package README before changing behavior. A-005 implements the contracts, shared legacy message/adapter shapes, frozen carriage profiles, capability RDF, guarded origins and the in-memory direct test binding. Provider modules remain reserved for their individual tasks.
A-025 implements ./graph-teams (createGraphTeamsReader, ORIGINS) and the
executor-only ./graph-teams/send (createGraphTeamsSend). Ingest uses Graph-only
bounded collection paging with resumable, account-scoped pending messages; channel
403s degrade the RDF descriptor without disabling chats. Use a reader per tenant/account.
Share HTML projection and envelope codecs. teams-card/0.1 carries the envelope
in Adaptive Card data.envelope, with matching visible text, an escaped HTML body
referencing the same stable attachment ID, and the required footer. Ingest projects
HTML only; text bodies and display names retain literal markup while stripping controls.
Acknowledgements use Teams' 64 KiB string / 1 MiB response JSON bounds, reading only
the message ID. Bind sender account, pinned chat and exact request in the approved
wire. Reads retry 429/503 with injected sleep/clock under attempt and wait bounds;
POST never retries because Graph chat sends have no idempotency key. No lookup or
final absence is advertised. See the README for poll, byte and consent limits.
Follow ADR-001 D4: Node >=24, ESM exports, workspace dependencies, strict TypeScript, Biome, and Vitest. Maintain 100% branches/functions/lines/statements coverage.
Never use live providers or credentials in tests. Fakes belong in ./testing;
production imports of that surface fail layer lint. Send implementations belong
exclusively in channel send subpaths, importable only by agent-executor and channel
tests. The guard permits only testing.ts's direct/send factory re-export for
test composition. Read credentials come only from TokenProvider.read; send
credentials come only from TokenProvider.send. Sending defaults to dry-run.
Every send must thread the executor's required synchronous io.assertAuthority()
through the scoped fetch call's request-local beforeDispatch hook. Transport factories
must run it after all awaits, including both outer and inner DNS/destination checks
and body buffering, immediately before underlying dispatch with no intervening await.
Recheck signed-message freshness there too. Direct delivery fences its local effect.
Wrap every local failure before effectful send dispatch in SendNotDispatchedError,
retaining the original cause and error type. Preserve ProviderRejectedError identity.
A read-only Matrix room-state preflight is not a send dispatch; errors after an actual
send dispatch retain their provider/uncertain meaning. Read-only ingest needs no fence.
Credential release alone is not continuing send authority.
Matrix transmit's room-state preflight also uses only the executor's io.tokens.send;
the construction-time read provider is exclusively for lookup. Refuse encrypted or
unreadable rooms. Export typed provider refusals through ./provider/send so the executor
can preserve definitive non-delivery without importing any reader.
Exception: the read-only GitHub binding (A-033) delegates authentication entirely
to gh auth and never consumes a TokenProvider. Keep its executable, host, GET
method and endpoint families fixed; invoke with an argument array and no shell.
Never follow notification URLs or expose child-process stdout/stderr in errors.
The daemon binds each reader's opaque account to a fixed active gh auth context.
There is no GitHub send half; the descriptor must keep sendSupported false.
The direct verifier is injected, local and pure; parsing never verifies signatures.
Reuse agent-model's capability record mapping rather than minting duplicate terms.
Only agent-model-gateway may
import OpenAI or Anthropic SDKs; the gateway must never import agent-audit.
04 同仓库更多 Skills
storage-conformance
Work on @jeswr/storage-conformance, the shared storage conformance suite package in the Solid SDK workspace.
fetch-rdf-engine-tests
Maintain fetch-rdf's real Node WASM parser integration tests without introducing a reverse engine dependency in fetch-rdf.
alpha
Use when checking fixtures, including folded YAML descriptions.
widget
Use when testing package skills: YAML quoting works.
web-seo
Use when improving technical and entity SEO for a modern personal, portfolio, documentation, or marketing site, including crawlable HTML, canonical metadata, sitemap and robots, Person/ProfilePage JSON-LD, Core Web Vitals, and honest ranking expectations.
solid-wac
Use when implementing or auditing Solid server WAC authorization, ACL creation and inheritance, auxiliary-resource escalation, method-to-mode mapping, 401 versus 403 challenges, WAC-Allow, or defensive typed ACL parsing with @solid/object and @rdfjs/wrapper.