@skaile/workspaces 5.8.0 → 5.9.0

package/dist/chunk-OJ4N4T4H.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../client/src/client.ts"],"names":[],"mappings":"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","file":"chunk-OJ4N4T4H.js","sourcesContent":["import type {\n  AgentCommand,\n  AgentPromptInput,\n  AgentEvent,\n  AgentReconfigureOptions,\n  AgentRuntimeConfig,\n  ClientTransport,\n  IAgentRuntime,\n} from \"@skaile/workspaces/types\";\n\n/**\n * Framework-agnostic protocol client for remote skaile agent servers.\n *\n * Implements `IAgentRuntime` over a pluggable `ClientTransport` (WebSocket, stdio,\n * in-process mock, etc.). Translates each `IAgentRuntime` method call into a typed\n * `AgentCommand` sent through the transport, and fans incoming `AgentEvent` messages\n * out to all handlers registered via `onEvent`. Key methods: `start()` optionally\n * connects the transport and sends initial configuration; `configure()` reconfigures\n * the agent at runtime; `prompt()` sends a user message; `sendStateAction()` pushes\n * an action to a shared state store; `dispose()` sends a shutdown command and\n * disconnects the transport.\n *\n * One `AgentClient` instance represents one connection to one agent server. Mapping\n * multiple session IDs to client instances is the consumer's responsibility (e.g.\n * `WsAgentGatewayService` in the platform backend uses `Map<sessionId, AgentClient>`).\n *\n * @example\n * ```ts\n * const transport = new WebSocketClientTransport({ url: 'ws://localhost:8080' });\n * const client = new AgentClient(transport);\n * await client.start({ projectDir: '/my/project' });\n * client.onEvent((e) => console.log(e));\n * await client.prompt('Hello');\n * await client.dispose();\n * ```\n *\n * @docLink packages/client/dev-guide#agent-client\n */\nexport class AgentClient implements IAgentRuntime {\n  private readonly transport: ClientTransport;\n  private readonly handlers = new Set<(event: AgentEvent) => void>();\n  private readonly unsubTransport: () => void;\n\n  constructor(transport: ClientTransport) {\n    this.transport = transport;\n    this.unsubTransport = transport.onMessage((event) => {\n      for (const handler of this.handlers) {\n        handler(event);\n      }\n    });\n  }\n\n  /** Connect transport (if needed) and send initial configuration. */\n  async start(config: AgentRuntimeConfig): Promise<void> {\n    if (!this.transport.connected) {\n      await this.transport.connect();\n    }\n    await this.configure(config);\n  }\n\n  /**\n   * @deprecated v2 reconfigure path. Protocol v3 replaces this with a one-shot\n   * `SessionInitCommand` envelope sent at session start; mid-session reconfig is\n   * routed through the `runner.*` capability surface. Kept for v2 callers; the\n   * cast survives because the wire shape is no longer in the `AgentCommand`\n   * union. Remove once forge apps have migrated to v3.\n   */\n  // @TODO: Code-Review: deprecated v2→v3 migration stub — remove once forge apps no longer call configure(); tracked as pre-publication cleanup\n  async configure(config: AgentReconfigureOptions): Promise<void> {\n    this.transport.send({ type: \"configure\", config } as unknown as AgentCommand);\n  }\n\n  /** Send a raw AgentCommand to the server. */\n  send(command: AgentCommand): void {\n    this.transport.send(command);\n  }\n\n  /** Send a user message to the agent. */\n  async prompt(message: string): Promise<void> {\n    this.transport.send({ type: \"prompt\", prompt: message });\n  }\n\n  async promptInput(input: AgentPromptInput): Promise<void> {\n    this.transport.send({ type: \"prompt\", prompt: input.text, attachments: input.attachments });\n  }\n\n  /**\n   * Answer an agent question. Pass `question` — verbatim from the `question`\n   * event being answered — whenever the user can answer a multi-question call\n   * out of order; without it the agent fills its next unanswered slot.\n   */\n  async reply(answer: string, question?: string, requestId?: string): Promise<void> {\n    this.transport.send({\n      type: \"reply\",\n      answer,\n      ...(question !== undefined ? { question } : {}),\n      ...(requestId !== undefined ? { requestId } : {}),\n    });\n  }\n\n  /** Cancel the current operation. */\n  async abort(): Promise<void> {\n    this.transport.send({ type: \"cancel\" });\n  }\n\n  /** Shut down the agent and disconnect transport. */\n  async dispose(): Promise<void> {\n    this.transport.send({ type: \"shutdown\" });\n    this.unsubTransport();\n    await this.transport.disconnect();\n  }\n\n  /**\n   * @deprecated v2 shared-state mutation path. Protocol v3 routes shared-state\n   * writes through the `runner.set_state` capability; this client method stays\n   * as a stop-gap for v2 callers. The cast survives because `state_action` is\n   * no longer in the `AgentCommand` union. Remove once forge apps have\n   * migrated to v3.\n   */\n  // @TODO: Code-Review: deprecated v2 stop-gap with unsafe `as unknown as AgentCommand` cast — remove once forge apps use runner.set_state capability\n  sendStateAction(store: string, action: Record<string, unknown>): void {\n    this.transport.send({ type: \"state_action\", store, action } as unknown as AgentCommand);\n  }\n\n  onEvent(handler: (event: AgentEvent) => void): void {\n    this.handlers.add(handler);\n  }\n\n  offEvent(handler: (event: AgentEvent) => void): void {\n    this.handlers.delete(handler);\n  }\n\n  get isRunning(): boolean {\n    return this.transport.connected;\n  }\n}\n"]}