foldkit-agent-a2a 0.9.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -49,6 +49,37 @@ result of binding that contract to your live host and verified principal.
49
49
 
50
50
  Generate the static Agent Card from the contract:
51
51
 
52
+ <!-- docs-check
53
+ import { Agent } from 'foldkit-agent'
54
+ import { Option, Schema } from 'effect'
55
+ import { defineMessageUnion } from 'foldkit/message'
56
+ const Message = defineMessageUnion({
57
+ RequestedCreateTodo: { title: Schema.String },
58
+ RequestedDeleteTodo: { id: Schema.String },
59
+ })
60
+ type Message = typeof Message.Type
61
+ interface Model {
62
+ readonly selectedTodoId: Option.Option<string>
63
+ }
64
+ const AgentBuilder = Agent.forModel<Model>()
65
+ const AssistantAgent = AgentBuilder.make({
66
+ messages: AgentBuilder.expose(Message, {
67
+ RequestedCreateTodo: 'Create a todo',
68
+ RequestedDeleteTodo: {
69
+ name: 'delete_todo',
70
+ description: 'Delete the selected todo',
71
+ available: model => Option.isSome(model.selectedTodoId),
72
+ },
73
+ }),
74
+ })
75
+ declare const currentModel: () => Model
76
+ declare const sendToRuntime: (message: Message) => void
77
+ const agentRuntime = AgentBuilder.bind({
78
+ definition: AssistantAgent,
79
+ host: { model: currentModel, dispatch: sendToRuntime },
80
+ })
81
+ -->
82
+
52
83
  ```ts
53
84
  import { AgentA2a } from 'foldkit-agent-a2a'
54
85
 
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/card.ts","../src/handler.ts","../src/agentA2a.ts"],"mappings":";;;;;;;;KASY,eAAe,MAAM;KAErB,aAAa,MAAM;;;;;;;;KASnB;UAuBK;WACN;WACA,IAAI;;WAEJ,QAAQ;;UAGF;WACN;WACA,IAAI;WACJ;aAAkB;aAAuB;;;KAGxC,WAAW,UAAU;;;;;;;KA0BrB;UAUK;WACN,OAAO;WACP;;WAEA,UAAU;;;;;;;;cASR,YAAU,OAAA,gBAAA,OAAA;;;;;;;KAQX,cAAc,WAAW;;;;;cAMxB,eAAa,OAAA;;;;;;;;;;;;;;KASd,iBAAiB,cAAc;UAK1B;WACN;WACA;WACA;WACA,QAAQ;WACR,SAAS,cAAc;;;cCtIrB;;UAGI;WACN;WACA;WACA;WACA,MAAM;;;;;;;;;;;;;;;;;;WAkBN,aAAa;;UAGP;WACN;WACA;WACA;;WAEA;;WAEA;WACA;WACA;aACE;aACA;;WAEF,mBAAmB;WACnB,oBAAoB;WACpB,QAAQ,cAAc;WACtB,kBAAkB;WAClB,WAAW,cAAc,eAAe;;cAGtC;UAEI;WACN;WACA;;WAEA;WACA;;WAEA,kBAAkB;WAClB,WAAW,cAAc,eAAe;;;;;;;;;cAUtC,YAAS,YAAgB,YAAU,SAAW,qBAAmB;UCtD7D;WACN,OAAO;;WAEP;;WAEA;WACA,eAAe;;UAGT;WACN,SAAS,qBAAqB,QAAQ;WACtC;;;;;;;;;cA+CE,UAAO,SAAa,mBAAiB"}
1
+ {"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/card.ts","../src/handler.ts","../src/agentA2a.ts"],"mappings":";;;;;;;;KASY,eAAe,MAAM;KAErB,aAAa,MAAM;;;;;;;;KASnB;UAuBK;WACN;WACA,IAAI;;WAEJ,QAAQ;;UAGF;WACN;WACA,IAAI;WACJ;aAAkB;aAAuB;;;KAGxC,WAAW,UAAU;;;;;;;KA0BrB;UAUK;WACN,OAAO;WACP;;WAEA,UAAU;;;;;;;;cASR,YAAU,OAAA,gBAAA,OAAA;;;;;;;KAQX,cAAc,WAAW;;;;;cAMxB,eAAa,OAAA;;;;;;;;;;;;;;KASd,iBAAiB,cAAc;UAK1B;WACN;WACA;WACA;WACA,QAAQ;WACR,SAAS,cAAc;;;cCtIrB;;UAGI;WACN;WACA;WACA;WACA,MAAM;;;;;;;;;;;;;;;;;;WAkBN,aAAa;;UAGP;WACN;WACA;WACA;;WAEA;;WAEA;WACA;WACA;aACE;aACA;;WAEF,mBAAmB;WACnB,oBAAoB;WACpB,QAAQ,cAAc;WACtB,kBAAkB;WAClB,WAAW,cAAc,eAAe;;cAGtC;UAEI;WACN;WACA;;WAEA;WACA;;WAEA,kBAAkB;WAClB,WAAW,cAAc,eAAe;;;;;;;;;cAUtC,YAAS,YAAgB,YAAU,SAAW,qBAAmB;UCtD7D;WACN,OAAO;;WAEP;;WAEA;WACA,eAAe;;UAGT;WACN,SAAS,qBAAqB,QAAQ;WACtC;;;;;;;;;cAgDE,UAAO,SAAa,mBAAiB"}
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":[],"sources":["../src/card.ts","../src/types.ts","../src/handler.ts","../src/agentA2a.ts"],"sourcesContent":["import { Agent } from 'foldkit-agent'\nimport type { Definition } from './types.js'\n\n/** Where an A2A client looks for the card. */\nexport const AGENT_CARD_PATH = '/.well-known/agent-card.json'\n\n/** One thing this agent can do. Derived from an exposed capability. */\nexport interface AgentSkill {\n readonly id: string\n readonly name: string\n readonly description: string\n readonly tags: ReadonlyArray<string>\n /**\n * The JSON Schema for this skill's input, as the contract derived it.\n *\n * Deliberately beyond the spec. A 0.3.0 `AgentSkill` describes its input only\n * in prose -- `inputModes` carries media types, not shapes -- so a caller has\n * nothing to construct a valid request from, which is the one thing this\n * contract already knows. The card validates because `AgentSkill` leaves\n * `additionalProperties` unset, not because the field is sanctioned.\n *\n * The risk is a later spec claiming this name for something else: the card\n * would not fail, it would quietly mean something a conforming client reads\n * differently. The spec-legal alternative is an `AgentExtension` under\n * `capabilities.extensions`, whose `params` would hold a skill-id-keyed map --\n * worth moving to when a real client consumes this, or the moment A2A\n * proposes a per-skill schema field. A conformance test pins the set of extra\n * keys so a second one cannot appear unnoticed.\n */\n readonly inputSchema: Record<string, unknown>\n}\n\nexport interface AgentCard {\n readonly protocolVersion: string\n readonly name: string\n readonly description: string\n /** Where this agent accepts A2A requests. */\n readonly url: string\n /** The transport bound to `url`. This adapter speaks JSON-RPC and nothing else. */\n readonly preferredTransport: 'JSONRPC'\n readonly version: string\n readonly capabilities: {\n readonly streaming: boolean\n readonly pushNotifications: boolean\n }\n readonly defaultInputModes: ReadonlyArray<string>\n readonly defaultOutputModes: ReadonlyArray<string>\n readonly skills: ReadonlyArray<AgentSkill>\n readonly securitySchemes?: Record<string, unknown> | undefined\n readonly security?: ReadonlyArray<Record<string, ReadonlyArray<string>>> | undefined\n}\n\nexport const A2A_VERSION = '0.3.0'\n\nexport interface AgentCardOptions {\n readonly name: string\n readonly description: string\n /** The endpoint that answers `message/send`. */\n readonly url: string\n readonly version?: string | undefined\n /** Declared so a client knows how to authenticate before it calls. */\n readonly securitySchemes?: Record<string, unknown> | undefined\n readonly security?: ReadonlyArray<Record<string, ReadonlyArray<string>>> | undefined\n}\n\n/**\n * Builds the card an A2A client fetches before calling.\n *\n * Skills are the exposed capabilities: the same descriptors MCP lists as tools.\n * A capability that is only available in some Model states is tagged, because a\n * card is static while availability is not.\n */\nexport const agentCard = (definition: Definition, options: AgentCardOptions): AgentCard => ({\n protocolVersion: A2A_VERSION,\n name: options.name,\n description: options.description,\n url: options.url,\n preferredTransport: 'JSONRPC',\n version: options.version ?? '0.1.0',\n // Streaming and push notifications are not implemented; saying otherwise\n // would have clients wait for events that never arrive.\n capabilities: { streaming: false, pushNotifications: false },\n defaultInputModes: ['application/json'],\n defaultOutputModes: ['application/json'],\n skills: Agent.messages(definition).map(capability => ({\n id: capability.name,\n name: capability.name,\n description: capability.description,\n tags: [\n ...(capability.modelDependent ? ['conditional'] : []),\n ...(capability.requiresAuthorization ? ['authorized'] : []),\n ],\n inputSchema: capability.inputSchema,\n })),\n ...(options.securitySchemes === undefined ? {} : { securitySchemes: options.securitySchemes }),\n ...(options.security === undefined ? {} : { security: options.security }),\n})\n","import { Schema } from 'effect'\nimport type { Agent } from 'foldkit-agent'\n\n/**\n * The bound contract, with its capability maps left open.\n *\n * An adapter reads names off the wire, so it works against the permissive maps\n * rather than a particular application's.\n */\nexport type AgentRuntime = Agent.AgentRuntime<any, any, any, any, any>\n\nexport type Definition = Agent.Definition<any, any, any, any, any>\n\n/**\n * The JSON-RPC envelope A2A uses.\n *\n * Deliberately a local copy rather than shared with `foldkit-agent-mcp`: two\n * protocols that happen to use the same envelope should not be coupled through\n * it.\n */\nexport type Id = string | number\n\nexport interface Request {\n readonly jsonrpc: '2.0'\n readonly id: Id\n readonly method: string\n /** Unvalidated until a method decides what its own params must look like. */\n readonly params?: unknown\n}\n\n/**\n * The envelope, decoded before anything reads a field off it.\n *\n * `params` stays `unknown` here: what a method requires is the method's\n * business, and deciding it here would answer bad params with the wrong code.\n */\nexport const RequestSchema = Schema.Struct({\n jsonrpc: Schema.Literal('2.0'),\n id: Schema.optional(Schema.Union([Schema.String, Schema.Number])),\n method: Schema.String,\n params: Schema.optional(Schema.Unknown),\n})\n\nexport interface Success {\n readonly jsonrpc: '2.0'\n readonly id: Id\n /** Every method this adapter answers successfully answers with a task. */\n readonly result: Task\n}\n\nexport interface Failure {\n readonly jsonrpc: '2.0'\n readonly id: Id | null\n readonly error: { readonly code: number; readonly message: string }\n}\n\nexport type Response = Success | Failure\n\nexport const code = {\n INVALID_REQUEST: -32600,\n METHOD_NOT_FOUND: -32601,\n INVALID_PARAMS: -32602,\n /** A2A: the task id is not one this agent issued. */\n TASK_NOT_FOUND: -32001,\n /** A2A: the task has already settled, so there is nothing left to cancel. */\n TASK_NOT_CANCELABLE: -32002,\n} as const\n\nexport const success = (id: Id, result: Task): Success => ({ jsonrpc: '2.0', id, result })\n\nexport const failure = (id: Id | null, errorCode: number, message: string): Failure => ({\n jsonrpc: '2.0',\n id,\n error: { code: errorCode, message },\n})\n\n/**\n * The subset of A2A 0.3.0 task states this adapter produces.\n *\n * `input-required`, `auth-required` and `unknown` are spec states no dispatch\n * here can reach, so they are left out rather than declared and never used.\n */\nexport type TaskState = 'submitted' | 'working' | 'completed' | 'failed' | 'canceled' | 'rejected'\n\n/** States a task cannot leave. A later settle must not overwrite one. */\nexport const terminal: ReadonlySet<TaskState> = new Set<TaskState>([\n 'completed',\n 'failed',\n 'canceled',\n 'rejected',\n])\n\nexport interface TaskStatus {\n readonly state: TaskState\n readonly timestamp: string\n /** What happened, in the agent's own words. */\n readonly message?: Message | undefined\n}\n\n/**\n * A part carries either text or data, and which one is not optional.\n *\n * A single struct with both fields optional would accept\n * `{ kind: 'data' }` and leave every reader to re-check.\n */\nexport const PartSchema = Schema.Union([\n Schema.Struct({ kind: Schema.Literal('text'), text: Schema.String }),\n Schema.Struct({\n kind: Schema.Literal('data'),\n data: Schema.Record(Schema.String, Schema.Unknown),\n }),\n])\n\nexport type Part = typeof PartSchema.Type\n\n/**\n * `kind` is required by the spec, not decoration: `Task | Message` is a union a\n * client discriminates on, so a message without it is not a Message.\n */\nexport const MessageSchema = Schema.Struct({\n kind: Schema.Literal('message'),\n role: Schema.Literals(['user', 'agent']),\n parts: Schema.Array(PartSchema),\n messageId: Schema.String,\n taskId: Schema.optional(Schema.String),\n contextId: Schema.optional(Schema.String),\n})\n\nexport type Message = typeof MessageSchema.Type\n\n/** What `message/send` requires of its params. */\nexport const SendParamsSchema = Schema.Struct({ message: MessageSchema })\n\nexport interface Task {\n readonly kind: 'task'\n readonly id: string\n readonly contextId: string\n readonly status: TaskStatus\n readonly history: ReadonlyArray<Message>\n}\n\nexport const text = (body: string): Part => ({ kind: 'text', text: body })\n","import { Agent } from 'foldkit-agent'\nimport { Effect, Schema } from 'effect'\nimport {\n type AgentRuntime,\n type Id,\n type Message,\n RequestSchema,\n type Response,\n SendParamsSchema,\n type Task,\n type TaskState,\n code,\n failure,\n success,\n terminal,\n text,\n} from './types.js'\n\nexport interface HandlerOptions {\n readonly agent: AgentRuntime\n /** Tasks kept for `tasks/get`. Defaults to 200. */\n readonly capacity?: number | undefined\n /** Injected for tests. */\n readonly newId?: (() => string) | undefined\n readonly clock?: (() => Date) | undefined\n}\n\nexport interface Handler {\n readonly handle: (message: unknown) => Promise<Response | undefined>\n readonly close: () => void\n}\n\nconst randomId = (): string =>\n typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function'\n ? crypto.randomUUID()\n : `a2a-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`\n\n/**\n * How a refused or finished dispatch reads as a task state.\n *\n * `rejected` is for a request the agent declined outright -- an unknown skill,\n * bad input, a caller who may not. `failed` is for work that was accepted and\n * did not succeed, which is a different thing to a client deciding what to do\n * next.\n */\nconst stateFor = (failureTag: string): TaskState => {\n switch (failureTag) {\n case 'AgentCancelledError':\n return 'canceled'\n case 'AgentCompletionTimeoutError':\n return 'failed'\n default:\n return 'rejected'\n }\n}\n\n/** The capability and input a client asked for, carried in a data part. */\nconst skillFrom = (\n message: Message,\n): { readonly skill: string; readonly input: unknown } | undefined => {\n const part = message.parts.find(candidate => candidate.kind === 'data')\n if (part === undefined) return undefined\n const skill = part.data['skill']\n return typeof skill === 'string' ? { skill, input: part.data['input'] ?? {} } : undefined\n}\n\nconst decodeRequest = Schema.decodeUnknownResult(RequestSchema)\nconst decodeSendParams = Schema.decodeUnknownResult(SendParamsSchema)\n\n/**\n * Serves a contract as an A2A agent, with no transport attached.\n *\n * One exposed capability is one skill. A capability with no completion contract\n * finishes at validated dispatch, so its task is `completed` immediately; one\n * that declares completion finishes when its Message arrives.\n */\nexport const handler = (options: HandlerOptions): Handler => {\n const { agent } = options\n const capacity = Math.max(1, options.capacity ?? 200)\n const newId = options.newId ?? randomId\n const clock = options.clock ?? (() => new Date())\n\n const tasks = new Map<string, Task>()\n const running = new Map<string, AbortController>()\n\n const remember = (task: Task): Task => {\n tasks.set(task.id, task)\n if (tasks.size > capacity) {\n const oldest = tasks.keys().next().value\n if (oldest !== undefined) tasks.delete(oldest)\n }\n return task\n }\n\n /**\n * Records how a task finished, unless it already finished.\n *\n * A cancel lands while the dispatch is still unwinding, so the settling write\n * arrives second and must not undo it. The task that stands is returned, so\n * the pending `message/send` answers with the same outcome `tasks/get` shows.\n */\n const settle = (task: Task): Task => {\n const current = tasks.get(task.id)\n return current !== undefined && terminal.has(current.status.state) ? current : remember(task)\n }\n\n const agentMessage = (body: string, taskId: string, contextId: string): Message => ({\n kind: 'message',\n role: 'agent',\n parts: [text(body)],\n messageId: newId(),\n taskId,\n contextId,\n })\n\n const send = async (id: Id, params: unknown): Promise<Response> => {\n const decoded = decodeSendParams(params)\n if (decoded._tag === 'Failure') {\n return failure(\n id,\n code.INVALID_PARAMS,\n 'message/send needs params as { message } with kind \"message\", a role, a messageId, and parts',\n )\n }\n\n const { message } = decoded.success\n const asked = skillFrom(message)\n\n if (asked === undefined) {\n return failure(\n id,\n code.INVALID_PARAMS,\n 'message/send needs a data part naming a skill, as { skill, input }',\n )\n }\n\n const taskId = newId()\n const contextId = message.contextId ?? newId()\n const history: ReadonlyArray<Message> = [message]\n\n const controller = new AbortController()\n running.set(taskId, controller)\n\n // Recorded before the work starts: a task a client cannot address while it\n // runs is a task it cannot get or cancel.\n remember({\n kind: 'task',\n id: taskId,\n contextId,\n status: { state: 'working', timestamp: clock().toISOString() },\n history,\n })\n\n try {\n // The signal reaches the run as well as the invocation. The runtime now\n // races the completion wait against it, so the invocation settles on its\n // own; interrupting the fiber additionally covers what the runtime cannot\n // see -- an abort landing while Schema decoding or a suspending authorize\n // hook is still in flight.\n const outcome = await Effect.runPromise(\n Effect.result(\n agent.messages.dispatchUnknown(asked.skill, asked.input, {\n id: taskId,\n transport: 'a2a',\n signal: controller.signal,\n }),\n ),\n { signal: controller.signal },\n )\n\n if (outcome._tag === 'Failure') {\n const error = outcome.failure\n return success(\n id,\n settle({\n kind: 'task',\n id: taskId,\n contextId,\n status: {\n state: stateFor(error._tag),\n timestamp: clock().toISOString(),\n message: agentMessage(error.message, taskId, contextId),\n },\n history,\n }),\n )\n }\n\n const result = outcome.success\n const summary = Agent.summarize(result)\n // A declared failure Message is work that ran and did not succeed.\n const state: TaskState = summary.ok ? 'completed' : 'failed'\n\n return success(\n id,\n settle({\n kind: 'task',\n id: taskId,\n contextId,\n status: {\n state,\n timestamp: clock().toISOString(),\n message: agentMessage(summary.text, taskId, contextId),\n },\n history,\n }),\n )\n } catch {\n return success(\n id,\n settle({\n kind: 'task',\n id: taskId,\n contextId,\n status: {\n state: 'failed',\n timestamp: clock().toISOString(),\n message: agentMessage(`Skill \"${asked.skill}\" failed unexpectedly`, taskId, contextId),\n },\n history,\n }),\n )\n } finally {\n running.delete(taskId)\n }\n }\n\n const handleRequest = async (id: Id, method: string, raw: unknown): Promise<Response> => {\n const params: Record<string, unknown> =\n typeof raw === 'object' && raw !== null && !Array.isArray(raw)\n ? (raw as Record<string, unknown>)\n : {}\n\n switch (method) {\n case 'message/send':\n return send(id, raw)\n\n case 'tasks/get': {\n const taskId = params['id']\n const task = typeof taskId === 'string' ? tasks.get(taskId) : undefined\n return task === undefined\n ? failure(id, code.TASK_NOT_FOUND, 'No such task')\n : success(id, task)\n }\n\n case 'tasks/cancel': {\n const taskId = params['id']\n const task = typeof taskId === 'string' ? tasks.get(taskId) : undefined\n if (task === undefined) return failure(id, code.TASK_NOT_FOUND, 'No such task')\n\n if (terminal.has(task.status.state)) {\n return failure(id, code.TASK_NOT_CANCELABLE, 'Task cannot be canceled')\n }\n\n // The canceled state is recorded before the abort, so the dispatch it\n // interrupts cannot settle over it on its way out. Cancelling stops the\n // waiting, not the Messages already dispatched.\n const canceled = remember({\n ...task,\n status: {\n state: 'canceled',\n timestamp: clock().toISOString(),\n message: agentMessage('Canceled by the client', task.id, task.contextId),\n },\n })\n running.get(task.id)?.abort()\n\n return success(id, canceled)\n }\n\n // Streaming is declared unsupported on the card, so it is refused here\n // rather than answered with something a client cannot consume.\n case 'message/stream':\n return failure(id, code.METHOD_NOT_FOUND, 'This agent does not support streaming')\n\n default:\n return failure(id, code.METHOD_NOT_FOUND, `Unknown method: ${method}`)\n }\n }\n\n return {\n handle: async (incoming: unknown): Promise<Response | undefined> => {\n if (Array.isArray(incoming)) {\n return failure(null, code.INVALID_REQUEST, 'Batched requests are not supported')\n }\n\n const decoded = decodeRequest(incoming)\n if (decoded._tag === 'Failure') {\n return failure(null, code.INVALID_REQUEST, 'Not a JSON-RPC 2.0 message')\n }\n\n const request = decoded.success\n // A notification carries no id and expects no reply.\n if (request.id === undefined) return undefined\n\n return handleRequest(request.id, request.method, request.params)\n },\n\n close: () => {\n for (const controller of running.values()) controller.abort()\n running.clear()\n tasks.clear()\n },\n }\n}\n","export {\n AGENT_CARD_PATH,\n A2A_VERSION,\n agentCard,\n type AgentCard,\n type AgentCardOptions,\n type AgentSkill,\n} from './card.js'\nexport { handler, type Handler, type HandlerOptions } from './handler.js'\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.mjs","names":[],"sources":["../src/card.ts","../src/types.ts","../src/handler.ts","../src/agentA2a.ts"],"sourcesContent":["import { Agent } from 'foldkit-agent'\nimport type { Definition } from './types.js'\n\n/** Where an A2A client looks for the card. */\nexport const AGENT_CARD_PATH = '/.well-known/agent-card.json'\n\n/** One thing this agent can do. Derived from an exposed capability. */\nexport interface AgentSkill {\n readonly id: string\n readonly name: string\n readonly description: string\n readonly tags: ReadonlyArray<string>\n /**\n * The JSON Schema for this skill's input, as the contract derived it.\n *\n * Deliberately beyond the spec. A 0.3.0 `AgentSkill` describes its input only\n * in prose -- `inputModes` carries media types, not shapes -- so a caller has\n * nothing to construct a valid request from, which is the one thing this\n * contract already knows. The card validates because `AgentSkill` leaves\n * `additionalProperties` unset, not because the field is sanctioned.\n *\n * The risk is a later spec claiming this name for something else: the card\n * would not fail, it would quietly mean something a conforming client reads\n * differently. The spec-legal alternative is an `AgentExtension` under\n * `capabilities.extensions`, whose `params` would hold a skill-id-keyed map --\n * worth moving to when a real client consumes this, or the moment A2A\n * proposes a per-skill schema field. A conformance test pins the set of extra\n * keys so a second one cannot appear unnoticed.\n */\n readonly inputSchema: Record<string, unknown>\n}\n\nexport interface AgentCard {\n readonly protocolVersion: string\n readonly name: string\n readonly description: string\n /** Where this agent accepts A2A requests. */\n readonly url: string\n /** The transport bound to `url`. This adapter speaks JSON-RPC and nothing else. */\n readonly preferredTransport: 'JSONRPC'\n readonly version: string\n readonly capabilities: {\n readonly streaming: boolean\n readonly pushNotifications: boolean\n }\n readonly defaultInputModes: ReadonlyArray<string>\n readonly defaultOutputModes: ReadonlyArray<string>\n readonly skills: ReadonlyArray<AgentSkill>\n readonly securitySchemes?: Record<string, unknown> | undefined\n readonly security?: ReadonlyArray<Record<string, ReadonlyArray<string>>> | undefined\n}\n\nexport const A2A_VERSION = '0.3.0'\n\nexport interface AgentCardOptions {\n readonly name: string\n readonly description: string\n /** The endpoint that answers `message/send`. */\n readonly url: string\n readonly version?: string | undefined\n /** Declared so a client knows how to authenticate before it calls. */\n readonly securitySchemes?: Record<string, unknown> | undefined\n readonly security?: ReadonlyArray<Record<string, ReadonlyArray<string>>> | undefined\n}\n\n/**\n * Builds the card an A2A client fetches before calling.\n *\n * Skills are the exposed capabilities: the same descriptors MCP lists as tools.\n * A capability that is only available in some Model states is tagged, because a\n * card is static while availability is not.\n */\nexport const agentCard = (definition: Definition, options: AgentCardOptions): AgentCard => ({\n protocolVersion: A2A_VERSION,\n name: options.name,\n description: options.description,\n url: options.url,\n preferredTransport: 'JSONRPC',\n version: options.version ?? '0.1.0',\n // Streaming and push notifications are not implemented; saying otherwise\n // would have clients wait for events that never arrive.\n capabilities: { streaming: false, pushNotifications: false },\n defaultInputModes: ['application/json'],\n defaultOutputModes: ['application/json'],\n skills: Agent.messages(definition).map(capability => ({\n id: capability.name,\n name: capability.name,\n description: capability.description,\n tags: [\n ...(capability.modelDependent ? ['conditional'] : []),\n ...(capability.requiresAuthorization ? ['authorized'] : []),\n ],\n inputSchema: capability.inputSchema,\n })),\n ...(options.securitySchemes === undefined ? {} : { securitySchemes: options.securitySchemes }),\n ...(options.security === undefined ? {} : { security: options.security }),\n})\n","import { Schema } from 'effect'\nimport type { Agent } from 'foldkit-agent'\n\n/**\n * The bound contract, with its capability maps left open.\n *\n * An adapter reads names off the wire, so it works against the permissive maps\n * rather than a particular application's.\n */\nexport type AgentRuntime = Agent.AgentRuntime<any, any, any, any, any>\n\nexport type Definition = Agent.Definition<any, any, any, any, any>\n\n/**\n * The JSON-RPC envelope A2A uses.\n *\n * Deliberately a local copy rather than shared with `foldkit-agent-mcp`: two\n * protocols that happen to use the same envelope should not be coupled through\n * it.\n */\nexport type Id = string | number\n\nexport interface Request {\n readonly jsonrpc: '2.0'\n readonly id: Id\n readonly method: string\n /** Unvalidated until a method decides what its own params must look like. */\n readonly params?: unknown\n}\n\n/**\n * The envelope, decoded before anything reads a field off it.\n *\n * `params` stays `unknown` here: what a method requires is the method's\n * business, and deciding it here would answer bad params with the wrong code.\n */\nexport const RequestSchema = Schema.Struct({\n jsonrpc: Schema.Literal('2.0'),\n id: Schema.optional(Schema.Union([Schema.String, Schema.Number])),\n method: Schema.String,\n params: Schema.optional(Schema.Unknown),\n})\n\nexport interface Success {\n readonly jsonrpc: '2.0'\n readonly id: Id\n /** Every method this adapter answers successfully answers with a task. */\n readonly result: Task\n}\n\nexport interface Failure {\n readonly jsonrpc: '2.0'\n readonly id: Id | null\n readonly error: { readonly code: number; readonly message: string }\n}\n\nexport type Response = Success | Failure\n\nexport const code = {\n INVALID_REQUEST: -32600,\n METHOD_NOT_FOUND: -32601,\n INVALID_PARAMS: -32602,\n /** A2A: the task id is not one this agent issued. */\n TASK_NOT_FOUND: -32001,\n /** A2A: the task has already settled, so there is nothing left to cancel. */\n TASK_NOT_CANCELABLE: -32002,\n} as const\n\nexport const success = (id: Id, result: Task): Success => ({ jsonrpc: '2.0', id, result })\n\nexport const failure = (id: Id | null, errorCode: number, message: string): Failure => ({\n jsonrpc: '2.0',\n id,\n error: { code: errorCode, message },\n})\n\n/**\n * The subset of A2A 0.3.0 task states this adapter produces.\n *\n * `input-required`, `auth-required` and `unknown` are spec states no dispatch\n * here can reach, so they are left out rather than declared and never used.\n */\nexport type TaskState = 'submitted' | 'working' | 'completed' | 'failed' | 'canceled' | 'rejected'\n\n/** States a task cannot leave. A later settle must not overwrite one. */\nexport const terminal: ReadonlySet<TaskState> = new Set<TaskState>([\n 'completed',\n 'failed',\n 'canceled',\n 'rejected',\n])\n\nexport interface TaskStatus {\n readonly state: TaskState\n readonly timestamp: string\n /** What happened, in the agent's own words. */\n readonly message?: Message | undefined\n}\n\n/**\n * A part carries either text or data, and which one is not optional.\n *\n * A single struct with both fields optional would accept\n * `{ kind: 'data' }` and leave every reader to re-check.\n */\nexport const PartSchema = Schema.Union([\n Schema.Struct({ kind: Schema.Literal('text'), text: Schema.String }),\n Schema.Struct({\n kind: Schema.Literal('data'),\n data: Schema.Record(Schema.String, Schema.Unknown),\n }),\n])\n\nexport type Part = typeof PartSchema.Type\n\n/**\n * `kind` is required by the spec, not decoration: `Task | Message` is a union a\n * client discriminates on, so a message without it is not a Message.\n */\nexport const MessageSchema = Schema.Struct({\n kind: Schema.Literal('message'),\n role: Schema.Literals(['user', 'agent']),\n parts: Schema.Array(PartSchema),\n messageId: Schema.String,\n taskId: Schema.optional(Schema.String),\n contextId: Schema.optional(Schema.String),\n})\n\nexport type Message = typeof MessageSchema.Type\n\n/** What `message/send` requires of its params. */\nexport const SendParamsSchema = Schema.Struct({ message: MessageSchema })\n\nexport interface Task {\n readonly kind: 'task'\n readonly id: string\n readonly contextId: string\n readonly status: TaskStatus\n readonly history: ReadonlyArray<Message>\n}\n\nexport const text = (body: string): Part => ({ kind: 'text', text: body })\n","import { Agent } from 'foldkit-agent'\nimport { Effect, Schema } from 'effect'\nimport {\n type AgentRuntime,\n type Id,\n type Message,\n RequestSchema,\n type Response,\n SendParamsSchema,\n type Task,\n type TaskState,\n code,\n failure,\n success,\n terminal,\n text,\n} from './types.js'\n\nexport interface HandlerOptions {\n readonly agent: AgentRuntime\n /** Tasks kept for `tasks/get`. Defaults to 200. */\n readonly capacity?: number | undefined\n /** Injected for tests. */\n readonly newId?: (() => string) | undefined\n readonly clock?: (() => Date) | undefined\n}\n\nexport interface Handler {\n readonly handle: (message: unknown) => Promise<Response | undefined>\n readonly close: () => void\n}\n\nconst randomId = (): string =>\n typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function'\n ? crypto.randomUUID()\n : `a2a-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`\n\n/**\n * How a refused or finished dispatch reads as a task state.\n *\n * `rejected` is for a request the agent declined outright -- an unknown skill,\n * bad input, a caller who may not. `failed` is for work that was accepted and\n * did not succeed, which is a different thing to a client deciding what to do\n * next.\n */\nconst stateFor = (failureTag: string): TaskState => {\n // tag-check: open, a failure's tag is any name an application chose; the rest are rejected\n switch (failureTag) {\n case 'AgentCancelledError':\n return 'canceled'\n case 'AgentCompletionTimeoutError':\n return 'failed'\n default:\n return 'rejected'\n }\n}\n\n/** The capability and input a client asked for, carried in a data part. */\nconst skillFrom = (\n message: Message,\n): { readonly skill: string; readonly input: unknown } | undefined => {\n const part = message.parts.find(candidate => candidate.kind === 'data')\n if (part === undefined) return undefined\n const skill = part.data['skill']\n return typeof skill === 'string' ? { skill, input: part.data['input'] ?? {} } : undefined\n}\n\nconst decodeRequest = Schema.decodeUnknownResult(RequestSchema)\nconst decodeSendParams = Schema.decodeUnknownResult(SendParamsSchema)\n\n/**\n * Serves a contract as an A2A agent, with no transport attached.\n *\n * One exposed capability is one skill. A capability with no completion contract\n * finishes at validated dispatch, so its task is `completed` immediately; one\n * that declares completion finishes when its Message arrives.\n */\nexport const handler = (options: HandlerOptions): Handler => {\n const { agent } = options\n const capacity = Math.max(1, options.capacity ?? 200)\n const newId = options.newId ?? randomId\n const clock = options.clock ?? (() => new Date())\n\n const tasks = new Map<string, Task>()\n const running = new Map<string, AbortController>()\n\n const remember = (task: Task): Task => {\n tasks.set(task.id, task)\n if (tasks.size > capacity) {\n const oldest = tasks.keys().next().value\n if (oldest !== undefined) tasks.delete(oldest)\n }\n return task\n }\n\n /**\n * Records how a task finished, unless it already finished.\n *\n * A cancel lands while the dispatch is still unwinding, so the settling write\n * arrives second and must not undo it. The task that stands is returned, so\n * the pending `message/send` answers with the same outcome `tasks/get` shows.\n */\n const settle = (task: Task): Task => {\n const current = tasks.get(task.id)\n return current !== undefined && terminal.has(current.status.state) ? current : remember(task)\n }\n\n const agentMessage = (body: string, taskId: string, contextId: string): Message => ({\n kind: 'message',\n role: 'agent',\n parts: [text(body)],\n messageId: newId(),\n taskId,\n contextId,\n })\n\n const send = async (id: Id, params: unknown): Promise<Response> => {\n const decoded = decodeSendParams(params)\n if (decoded._tag === 'Failure') {\n return failure(\n id,\n code.INVALID_PARAMS,\n 'message/send needs params as { message } with kind \"message\", a role, a messageId, and parts',\n )\n }\n\n const { message } = decoded.success\n const asked = skillFrom(message)\n\n if (asked === undefined) {\n return failure(\n id,\n code.INVALID_PARAMS,\n 'message/send needs a data part naming a skill, as { skill, input }',\n )\n }\n\n const taskId = newId()\n const contextId = message.contextId ?? newId()\n const history: ReadonlyArray<Message> = [message]\n\n const controller = new AbortController()\n running.set(taskId, controller)\n\n // Recorded before the work starts: a task a client cannot address while it\n // runs is a task it cannot get or cancel.\n remember({\n kind: 'task',\n id: taskId,\n contextId,\n status: { state: 'working', timestamp: clock().toISOString() },\n history,\n })\n\n try {\n // The signal reaches the run as well as the invocation. The runtime now\n // races the completion wait against it, so the invocation settles on its\n // own; interrupting the fiber additionally covers what the runtime cannot\n // see -- an abort landing while Schema decoding or a suspending authorize\n // hook is still in flight.\n const outcome = await Effect.runPromise(\n Effect.result(\n agent.messages.dispatchUnknown(asked.skill, asked.input, {\n id: taskId,\n transport: 'a2a',\n signal: controller.signal,\n }),\n ),\n { signal: controller.signal },\n )\n\n if (outcome._tag === 'Failure') {\n const error = outcome.failure\n return success(\n id,\n settle({\n kind: 'task',\n id: taskId,\n contextId,\n status: {\n state: stateFor(error._tag),\n timestamp: clock().toISOString(),\n message: agentMessage(error.message, taskId, contextId),\n },\n history,\n }),\n )\n }\n\n const result = outcome.success\n const summary = Agent.summarize(result)\n // A declared failure Message is work that ran and did not succeed.\n const state: TaskState = summary.ok ? 'completed' : 'failed'\n\n return success(\n id,\n settle({\n kind: 'task',\n id: taskId,\n contextId,\n status: {\n state,\n timestamp: clock().toISOString(),\n message: agentMessage(summary.text, taskId, contextId),\n },\n history,\n }),\n )\n } catch {\n return success(\n id,\n settle({\n kind: 'task',\n id: taskId,\n contextId,\n status: {\n state: 'failed',\n timestamp: clock().toISOString(),\n message: agentMessage(`Skill \"${asked.skill}\" failed unexpectedly`, taskId, contextId),\n },\n history,\n }),\n )\n } finally {\n running.delete(taskId)\n }\n }\n\n const handleRequest = async (id: Id, method: string, raw: unknown): Promise<Response> => {\n const params: Record<string, unknown> =\n typeof raw === 'object' && raw !== null && !Array.isArray(raw)\n ? (raw as Record<string, unknown>)\n : {}\n\n switch (method) {\n case 'message/send':\n return send(id, raw)\n\n case 'tasks/get': {\n const taskId = params['id']\n const task = typeof taskId === 'string' ? tasks.get(taskId) : undefined\n return task === undefined\n ? failure(id, code.TASK_NOT_FOUND, 'No such task')\n : success(id, task)\n }\n\n case 'tasks/cancel': {\n const taskId = params['id']\n const task = typeof taskId === 'string' ? tasks.get(taskId) : undefined\n if (task === undefined) return failure(id, code.TASK_NOT_FOUND, 'No such task')\n\n if (terminal.has(task.status.state)) {\n return failure(id, code.TASK_NOT_CANCELABLE, 'Task cannot be canceled')\n }\n\n // The canceled state is recorded before the abort, so the dispatch it\n // interrupts cannot settle over it on its way out. Cancelling stops the\n // waiting, not the Messages already dispatched.\n const canceled = remember({\n ...task,\n status: {\n state: 'canceled',\n timestamp: clock().toISOString(),\n message: agentMessage('Canceled by the client', task.id, task.contextId),\n },\n })\n running.get(task.id)?.abort()\n\n return success(id, canceled)\n }\n\n // Streaming is declared unsupported on the card, so it is refused here\n // rather than answered with something a client cannot consume.\n case 'message/stream':\n return failure(id, code.METHOD_NOT_FOUND, 'This agent does not support streaming')\n\n default:\n return failure(id, code.METHOD_NOT_FOUND, `Unknown method: ${method}`)\n }\n }\n\n return {\n handle: async (incoming: unknown): Promise<Response | undefined> => {\n if (Array.isArray(incoming)) {\n return failure(null, code.INVALID_REQUEST, 'Batched requests are not supported')\n }\n\n const decoded = decodeRequest(incoming)\n if (decoded._tag === 'Failure') {\n return failure(null, code.INVALID_REQUEST, 'Not a JSON-RPC 2.0 message')\n }\n\n const request = decoded.success\n // A notification carries no id and expects no reply.\n if (request.id === undefined) return undefined\n\n return handleRequest(request.id, request.method, request.params)\n },\n\n close: () => {\n for (const controller of running.values()) controller.abort()\n running.clear()\n tasks.clear()\n },\n }\n}\n","export {\n AGENT_CARD_PATH,\n A2A_VERSION,\n agentCard,\n type AgentCard,\n type AgentCardOptions,\n type AgentSkill,\n} from './card.js'\nexport { handler, type Handler, type HandlerOptions } from './handler.js'\n"],"mappings":";;;;;AAIA,MAAa,kBAAkB;AAgD/B,MAAa,cAAc;;;;;;;;AAoB3B,MAAa,aAAa,YAAwB,aAA0C;CAC1F,iBAAiB;CACjB,MAAM,QAAQ;CACd,aAAa,QAAQ;CACrB,KAAK,QAAQ;CACb,oBAAoB;CACpB,SAAS,QAAQ,WAAW;CAG5B,cAAc;EAAE,WAAW;EAAO,mBAAmB;CAAM;CAC3D,mBAAmB,CAAC,kBAAkB;CACtC,oBAAoB,CAAC,kBAAkB;CACvC,QAAQ,MAAM,SAAS,UAAU,CAAC,CAAC,KAAI,gBAAe;EACpD,IAAI,WAAW;EACf,MAAM,WAAW;EACjB,aAAa,WAAW;EACxB,MAAM,CACJ,GAAI,WAAW,iBAAiB,CAAC,aAAa,IAAI,CAAC,GACnD,GAAI,WAAW,wBAAwB,CAAC,YAAY,IAAI,CAAC,CAC3D;EACA,aAAa,WAAW;CAC1B,EAAE;CACF,GAAI,QAAQ,oBAAoB,KAAA,IAAY,CAAC,IAAI,EAAE,iBAAiB,QAAQ,gBAAgB;CAC5F,GAAI,QAAQ,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,QAAQ,SAAS;AACzE;;;;;;;;AC5DA,MAAa,gBAAgB,OAAO,OAAO;CACzC,SAAS,OAAO,QAAQ,KAAK;CAC7B,IAAI,OAAO,SAAS,OAAO,MAAM,CAAC,OAAO,QAAQ,OAAO,MAAM,CAAC,CAAC;CAChE,QAAQ,OAAO;CACf,QAAQ,OAAO,SAAS,OAAO,OAAO;AACxC,CAAC;AAiBD,MAAa,OAAO;CAClB,iBAAiB;CACjB,kBAAkB;CAClB,gBAAgB;;CAEhB,gBAAgB;;CAEhB,qBAAqB;AACvB;AAEA,MAAa,WAAW,IAAQ,YAA2B;CAAE,SAAS;CAAO;CAAI;AAAO;AAExF,MAAa,WAAW,IAAe,WAAmB,aAA8B;CACtF,SAAS;CACT;CACA,OAAO;EAAE,MAAM;EAAW;CAAQ;AACpC;;AAWA,MAAa,2BAAmC,IAAI,IAAe;CACjE;CACA;CACA;CACA;AACF,CAAC;;;;;;;AAeD,MAAa,aAAa,OAAO,MAAM,CACrC,OAAO,OAAO;CAAE,MAAM,OAAO,QAAQ,MAAM;CAAG,MAAM,OAAO;AAAO,CAAC,GACnE,OAAO,OAAO;CACZ,MAAM,OAAO,QAAQ,MAAM;CAC3B,MAAM,OAAO,OAAO,OAAO,QAAQ,OAAO,OAAO;AACnD,CAAC,CACH,CAAC;;;;;AAQD,MAAa,gBAAgB,OAAO,OAAO;CACzC,MAAM,OAAO,QAAQ,SAAS;CAC9B,MAAM,OAAO,SAAS,CAAC,QAAQ,OAAO,CAAC;CACvC,OAAO,OAAO,MAAM,UAAU;CAC9B,WAAW,OAAO;CAClB,QAAQ,OAAO,SAAS,OAAO,MAAM;CACrC,WAAW,OAAO,SAAS,OAAO,MAAM;AAC1C,CAAC;;AAKD,MAAa,mBAAmB,OAAO,OAAO,EAAE,SAAS,cAAc,CAAC;AAUxE,MAAa,QAAQ,UAAwB;CAAE,MAAM;CAAQ,MAAM;AAAK;;AC7GxE,MAAM,iBACJ,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,aAC1D,OAAO,WAAW,IAClB,OAAO,KAAK,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,GAAG,KAAK,OAAO,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;;;;;;;;;AAU1E,MAAM,YAAY,eAAkC;CAElD,QAAQ,YAAR;EACE,KAAK,uBACH,OAAO;EACT,KAAK,+BACH,OAAO;EACT,SACE,OAAO;CACX;AACF;;AAGA,MAAM,aACJ,YACoE;CACpE,MAAM,OAAO,QAAQ,MAAM,MAAK,cAAa,UAAU,SAAS,MAAM;CACtE,IAAI,SAAS,KAAA,GAAW,OAAO,KAAA;CAC/B,MAAM,QAAQ,KAAK,KAAK;CACxB,OAAO,OAAO,UAAU,WAAW;EAAE;EAAO,OAAO,KAAK,KAAK,YAAY,CAAC;CAAE,IAAI,KAAA;AAClF;AAEA,MAAM,gBAAgB,OAAO,oBAAoB,aAAa;AAC9D,MAAM,mBAAmB,OAAO,oBAAoB,gBAAgB;;;;;;;;AASpE,MAAa,WAAW,YAAqC;CAC3D,MAAM,EAAE,UAAU;CAClB,MAAM,WAAW,KAAK,IAAI,GAAG,QAAQ,YAAY,GAAG;CACpD,MAAM,QAAQ,QAAQ,SAAS;CAC/B,MAAM,QAAQ,QAAQ,gCAAgB,IAAI,KAAK;CAE/C,MAAM,wBAAQ,IAAI,IAAkB;CACpC,MAAM,0BAAU,IAAI,IAA6B;CAEjD,MAAM,YAAY,SAAqB;EACrC,MAAM,IAAI,KAAK,IAAI,IAAI;EACvB,IAAI,MAAM,OAAO,UAAU;GACzB,MAAM,SAAS,MAAM,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;GACnC,IAAI,WAAW,KAAA,GAAW,MAAM,OAAO,MAAM;EAC/C;EACA,OAAO;CACT;;;;;;;;CASA,MAAM,UAAU,SAAqB;EACnC,MAAM,UAAU,MAAM,IAAI,KAAK,EAAE;EACjC,OAAO,YAAY,KAAA,KAAa,SAAS,IAAI,QAAQ,OAAO,KAAK,IAAI,UAAU,SAAS,IAAI;CAC9F;CAEA,MAAM,gBAAgB,MAAc,QAAgB,eAAgC;EAClF,MAAM;EACN,MAAM;EACN,OAAO,CAAC,KAAK,IAAI,CAAC;EAClB,WAAW,MAAM;EACjB;EACA;CACF;CAEA,MAAM,OAAO,OAAO,IAAQ,WAAuC;EACjE,MAAM,UAAU,iBAAiB,MAAM;EACvC,IAAI,QAAQ,SAAS,WACnB,OAAO,QACL,IACA,KAAK,gBACL,gGACF;EAGF,MAAM,EAAE,YAAY,QAAQ;EAC5B,MAAM,QAAQ,UAAU,OAAO;EAE/B,IAAI,UAAU,KAAA,GACZ,OAAO,QACL,IACA,KAAK,gBACL,oEACF;EAGF,MAAM,SAAS,MAAM;EACrB,MAAM,YAAY,QAAQ,aAAa,MAAM;EAC7C,MAAM,UAAkC,CAAC,OAAO;EAEhD,MAAM,aAAa,IAAI,gBAAgB;EACvC,QAAQ,IAAI,QAAQ,UAAU;EAI9B,SAAS;GACP,MAAM;GACN,IAAI;GACJ;GACA,QAAQ;IAAE,OAAO;IAAW,WAAW,MAAM,CAAC,CAAC,YAAY;GAAE;GAC7D;EACF,CAAC;EAED,IAAI;GAMF,MAAM,UAAU,MAAM,OAAO,WAC3B,OAAO,OACL,MAAM,SAAS,gBAAgB,MAAM,OAAO,MAAM,OAAO;IACvD,IAAI;IACJ,WAAW;IACX,QAAQ,WAAW;GACrB,CAAC,CACH,GACA,EAAE,QAAQ,WAAW,OAAO,CAC9B;GAEA,IAAI,QAAQ,SAAS,WAAW;IAC9B,MAAM,QAAQ,QAAQ;IACtB,OAAO,QACL,IACA,OAAO;KACL,MAAM;KACN,IAAI;KACJ;KACA,QAAQ;MACN,OAAO,SAAS,MAAM,IAAI;MAC1B,WAAW,MAAM,CAAC,CAAC,YAAY;MAC/B,SAAS,aAAa,MAAM,SAAS,QAAQ,SAAS;KACxD;KACA;IACF,CAAC,CACH;GACF;GAEA,MAAM,SAAS,QAAQ;GACvB,MAAM,UAAU,MAAM,UAAU,MAAM;GAEtC,MAAM,QAAmB,QAAQ,KAAK,cAAc;GAEpD,OAAO,QACL,IACA,OAAO;IACL,MAAM;IACN,IAAI;IACJ;IACA,QAAQ;KACN;KACA,WAAW,MAAM,CAAC,CAAC,YAAY;KAC/B,SAAS,aAAa,QAAQ,MAAM,QAAQ,SAAS;IACvD;IACA;GACF,CAAC,CACH;EACF,QAAQ;GACN,OAAO,QACL,IACA,OAAO;IACL,MAAM;IACN,IAAI;IACJ;IACA,QAAQ;KACN,OAAO;KACP,WAAW,MAAM,CAAC,CAAC,YAAY;KAC/B,SAAS,aAAa,UAAU,MAAM,MAAM,wBAAwB,QAAQ,SAAS;IACvF;IACA;GACF,CAAC,CACH;EACF,UAAU;GACR,QAAQ,OAAO,MAAM;EACvB;CACF;CAEA,MAAM,gBAAgB,OAAO,IAAQ,QAAgB,QAAoC;EACvF,MAAM,SACJ,OAAO,QAAQ,YAAY,QAAQ,QAAQ,CAAC,MAAM,QAAQ,GAAG,IACxD,MACD,CAAC;EAEP,QAAQ,QAAR;GACE,KAAK,gBACH,OAAO,KAAK,IAAI,GAAG;GAErB,KAAK,aAAa;IAChB,MAAM,SAAS,OAAO;IACtB,MAAM,OAAO,OAAO,WAAW,WAAW,MAAM,IAAI,MAAM,IAAI,KAAA;IAC9D,OAAO,SAAS,KAAA,IACZ,QAAQ,IAAI,KAAK,gBAAgB,cAAc,IAC/C,QAAQ,IAAI,IAAI;GACtB;GAEA,KAAK,gBAAgB;IACnB,MAAM,SAAS,OAAO;IACtB,MAAM,OAAO,OAAO,WAAW,WAAW,MAAM,IAAI,MAAM,IAAI,KAAA;IAC9D,IAAI,SAAS,KAAA,GAAW,OAAO,QAAQ,IAAI,KAAK,gBAAgB,cAAc;IAE9E,IAAI,SAAS,IAAI,KAAK,OAAO,KAAK,GAChC,OAAO,QAAQ,IAAI,KAAK,qBAAqB,yBAAyB;IAMxE,MAAM,WAAW,SAAS;KACxB,GAAG;KACH,QAAQ;MACN,OAAO;MACP,WAAW,MAAM,CAAC,CAAC,YAAY;MAC/B,SAAS,aAAa,0BAA0B,KAAK,IAAI,KAAK,SAAS;KACzE;IACF,CAAC;IACD,QAAQ,IAAI,KAAK,EAAE,CAAC,EAAE,MAAM;IAE5B,OAAO,QAAQ,IAAI,QAAQ;GAC7B;GAIA,KAAK,kBACH,OAAO,QAAQ,IAAI,KAAK,kBAAkB,uCAAuC;GAEnF,SACE,OAAO,QAAQ,IAAI,KAAK,kBAAkB,mBAAmB,QAAQ;EACzE;CACF;CAEA,OAAO;EACL,QAAQ,OAAO,aAAqD;GAClE,IAAI,MAAM,QAAQ,QAAQ,GACxB,OAAO,QAAQ,MAAM,KAAK,iBAAiB,oCAAoC;GAGjF,MAAM,UAAU,cAAc,QAAQ;GACtC,IAAI,QAAQ,SAAS,WACnB,OAAO,QAAQ,MAAM,KAAK,iBAAiB,4BAA4B;GAGzE,MAAM,UAAU,QAAQ;GAExB,IAAI,QAAQ,OAAO,KAAA,GAAW,OAAO,KAAA;GAErC,OAAO,cAAc,QAAQ,IAAI,QAAQ,QAAQ,QAAQ,MAAM;EACjE;EAEA,aAAa;GACX,KAAK,MAAM,cAAc,QAAQ,OAAO,GAAG,WAAW,MAAM;GAC5D,QAAQ,MAAM;GACd,MAAM,MAAM;EACd;CACF;AACF"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "foldkit-agent-a2a",
3
- "version": "0.9.0",
3
+ "version": "0.10.0",
4
4
  "description": "A2A adapter for foldkit-agent. Serves a Foldkit agent contract as an A2A agent.",
5
5
  "keywords": [
6
6
  "foldkit",
@@ -39,7 +39,7 @@
39
39
  "peerDependencies": {
40
40
  "effect": "^4.1.0",
41
41
  "foldkit": "^0.170.0",
42
- "foldkit-agent": "^0.11.0"
42
+ "foldkit-agent": "^0.12.0"
43
43
  },
44
44
  "devDependencies": {
45
45
  "@effect/platform-browser": "^4.1.1",
@@ -47,7 +47,7 @@
47
47
  "foldkit": "0.170.0",
48
48
  "tsdown": "^0.23.1",
49
49
  "typescript": "7.0.2",
50
- "foldkit-agent": "0.11.0"
50
+ "foldkit-agent": "0.12.0"
51
51
  },
52
52
  "scripts": {
53
53
  "build": "node ../../scripts/declarations.mjs . && tsdown && node ../../scripts/declared-any.mjs .",