51f233582d
Align call-protocol.md and api-surface.md with envelope model
...
Remove supersession note from response-envelopes.md — both dependent
docs now reflect the ResponseEnvelope system. Key changes:
- call-protocol.md: CallHandler wraps and publishes (not handlers),
call.responded.output uses ResponseEnvelopeSchema, respond() enforces
envelope guard, call() resolves ResponseEnvelope, subscribe() yields
ResponseEnvelope, references shared result pipeline
- api-surface.md: execute() returns Promise<ResponseEnvelope<TOutput>>,
OperationEnv functions return Promise<ResponseEnvelope>, CallHandler
calls handler directly and applies shared pipeline, respond() requires
ResponseEnvelope, added Response Envelope Types and Utilities sections
- response-envelopes.md: removed supersession note, added Shared Result
Pipeline section (detect→wrap→normalize→validate), unified execute()
and CallHandler integration points to reference shared pipeline,
updated migration checklist to mark doc changes complete
2026-05-10 08:37:40 +00:00
d0017df2bf
Update architecture docs for handler separation and pubsub API changes
...
- api-surface.md: Updated registry API table (registerSpec, registerHandler,
getHandler, separated spec/handler storage), OperationSpec description,
IOperationDefinition marked as convenience type, adapter return types
- call-protocol.md: Added pubsub EventEnvelope unwrapping details,
subscribe(type, id) 2-arg API, handler separation in buildCallHandler
and subscribe(), handler separation section
- adapters.md: Updated return types (OperationSpec & { handler }),
scanner validates against OperationSpecSchema, new module shape examples
showing spec-only and spec+handler patterns, typemap mention
- README.md: Core principle updated for spec/handler separation
- build-distribution.md: Updated pubsub dep description, registry.ts description
- AGENTS.md: Updated key points, source layout, provenance status
2026-05-09 08:34:41 +00:00
29f0dd7af0
Initial package implementation: operations registry, call protocol, and adapters
...
Extracted from alkhub_ts packages/core/operations/ and packages/core/mcp/.
- Runtime-agnostic (injected fs/env deps, no Deno globals)
- Direct @logtape/logtape import instead of logger wrapper
- PendingRequestMap with pubsub-wired call protocol
- Peer-dep isolation for MCP adapter (sub-path export)
- Schema const naming convention (XSchema + X type alias)
- 68 tests passing, build + lint + test all green
2026-04-30 12:34:26 +00:00
