bs-agent 0.0.9 → 0.0.12

package/dist/core/index.d.cts

@@ -0,0 +1,133 @@
+import { S as SessionId, a as StreamCallbacks, P as PausedToolInfo, C as ClientTool, A as AgentConfig, b as StreamOptions } from '../types-DryLPWU9.cjs';
+export { f as AgentHandoffEvent, E as ExecuteRequestBody, R as ReasoningDeltaEvent, i as RunErrorEvent, c as StreamEvent, d as StreamEventMeta, e as TextDeltaEvent, h as ToolCallEndEvent, g as ToolCallStartEvent, T as ToolType } from '../types-DryLPWU9.cjs';
+export { ZodSchema, toJSONSchema, z } from 'zod';
+
+/**
+ * Represents a conversation session with a BuildShip agent.
+ *
+ * Sessions maintain history across multiple turns and support
+ * pause/resume for blocking client tools.
+ */
+declare class AgentSession {
+    /** @internal */ private _agent;
+    /** @internal */ private _sessionId;
+    /** @internal */ private _paused;
+    /** @internal */ private _pausedToolInfo;
+    /** @internal */ private _abortController;
+    /** @internal */
+    constructor(agent: BuildShipAgent, sessionId?: SessionId);
+    /**
+     * Send a message in this session.
+     *
+     * @param message   - The message to send
+     * @param callbacks - Event handlers for the stream
+     * @param context   - Optional additional context data
+     * @returns This session (for chaining)
+     */
+    execute(message: string, callbacks: StreamCallbacks, context?: Record<string, any>): Promise<AgentSession>;
+    /**
+     * Resume a paused session with a tool result.
+     *
+     * @param result    - The result to send back to the agent
+     * @param callbacks - Event handlers for the resumed stream
+     * @returns This session (for chaining)
+     */
+    resume(result: any, callbacks: StreamCallbacks): Promise<AgentSession>;
+    /**
+     * Check if this session is waiting for a tool result.
+     */
+    isPaused(): boolean;
+    /**
+     * Get information about the paused tool call.
+     * Returns `null` if the session is not paused.
+     */
+    getPausedTool(): PausedToolInfo | null;
+    /**
+     * Get the session ID.
+     * May be `undefined` if the session hasn't executed yet.
+     */
+    getSessionId(): SessionId;
+    /**
+     * Cancel the current streaming operation.
+     */
+    abort(): void;
+    /** @internal */
+    private _run;
+    /** @internal */
+    private _getClientToolDefs;
+}
+
+/**
+ * Main entry point for interacting with a BuildShip agent.
+ *
+ * @example
+ * ```ts
+ * import { BuildShipAgent } from "buildship-agent-sdk/core";
+ *
+ * const agent = new BuildShipAgent({
+ *   agentId: "your-agent-id",
+ *   accessKey: "your-access-key",
+ * });
+ *
+ * const session = await agent.execute("Hello!", {
+ *   onText: (text) => console.log(text),
+ *   onComplete: (fullText) => console.log("Done!", fullText),
+ * });
+ * ```
+ */
+declare class BuildShipAgent {
+    /** @internal */ readonly _agentId: string;
+    /** @internal */ readonly _accessKey?: string;
+    /** @internal */ readonly _baseUrl: string;
+    /** @internal */ readonly _clientTools: Map<string, ClientTool>;
+    constructor(config: AgentConfig);
+    /**
+     * The URL for the agent's execute endpoint.
+     * @internal
+     */
+    get _url(): string;
+    /**
+     * Build the authorization / common headers.
+     * @internal
+     */
+    _buildHeaders(sessionId?: SessionId): Record<string, string>;
+    /**
+     * Start a new conversation.
+     *
+     * Creates a fresh session and sends the first message.
+     *
+     * @param message  - The message to send
+     * @param callbacks - Event handlers for the stream
+     * @param context   - Optional additional context data
+     * @returns The new session
+     */
+    execute(message: string, callbacks: StreamCallbacks, context?: Record<string, any>): Promise<AgentSession>;
+    /**
+     * Get an existing session by ID to continue a conversation.
+     *
+     * @param sessionId - The session ID from a previous conversation
+     * @returns The session object
+     */
+    session(sessionId: SessionId | string): AgentSession;
+    /**
+     * Register a client-side tool that the agent can call.
+     */
+    registerClientTool(tool: ClientTool): void;
+    /**
+     * Remove a registered client tool.
+     */
+    unregisterClientTool(name: string): void;
+}
+
+/**
+ * Opens an SSE connection to the BuildShip agent endpoint using native
+ * `fetch` + `ReadableStream`, parses events, and dispatches to the
+ * appropriate callbacks.
+ *
+ * Zero runtime dependencies — works in both browser and Node.js.
+ *
+ * @internal
+ */
+declare function executeStream(options: StreamOptions): Promise<void>;
+
+export { AgentConfig, AgentSession, BuildShipAgent, ClientTool, PausedToolInfo, SessionId, StreamCallbacks, StreamOptions, executeStream };

package/dist/core/index.d.ts

@@ -0,0 +1,133 @@
+import { S as SessionId, a as StreamCallbacks, P as PausedToolInfo, C as ClientTool, A as AgentConfig, b as StreamOptions } from '../types-DryLPWU9.js';
+export { f as AgentHandoffEvent, E as ExecuteRequestBody, R as ReasoningDeltaEvent, i as RunErrorEvent, c as StreamEvent, d as StreamEventMeta, e as TextDeltaEvent, h as ToolCallEndEvent, g as ToolCallStartEvent, T as ToolType } from '../types-DryLPWU9.js';
+export { ZodSchema, toJSONSchema, z } from 'zod';
+
+/**
+ * Represents a conversation session with a BuildShip agent.
+ *
+ * Sessions maintain history across multiple turns and support
+ * pause/resume for blocking client tools.
+ */
+declare class AgentSession {
+    /** @internal */ private _agent;
+    /** @internal */ private _sessionId;
+    /** @internal */ private _paused;
+    /** @internal */ private _pausedToolInfo;
+    /** @internal */ private _abortController;
+    /** @internal */
+    constructor(agent: BuildShipAgent, sessionId?: SessionId);
+    /**
+     * Send a message in this session.
+     *
+     * @param message   - The message to send
+     * @param callbacks - Event handlers for the stream
+     * @param context   - Optional additional context data
+     * @returns This session (for chaining)
+     */
+    execute(message: string, callbacks: StreamCallbacks, context?: Record<string, any>): Promise<AgentSession>;
+    /**
+     * Resume a paused session with a tool result.
+     *
+     * @param result    - The result to send back to the agent
+     * @param callbacks - Event handlers for the resumed stream
+     * @returns This session (for chaining)
+     */
+    resume(result: any, callbacks: StreamCallbacks): Promise<AgentSession>;
+    /**
+     * Check if this session is waiting for a tool result.
+     */
+    isPaused(): boolean;
+    /**
+     * Get information about the paused tool call.
+     * Returns `null` if the session is not paused.
+     */
+    getPausedTool(): PausedToolInfo | null;
+    /**
+     * Get the session ID.
+     * May be `undefined` if the session hasn't executed yet.
+     */
+    getSessionId(): SessionId;
+    /**
+     * Cancel the current streaming operation.
+     */
+    abort(): void;
+    /** @internal */
+    private _run;
+    /** @internal */
+    private _getClientToolDefs;
+}
+
+/**
+ * Main entry point for interacting with a BuildShip agent.
+ *
+ * @example
+ * ```ts
+ * import { BuildShipAgent } from "buildship-agent-sdk/core";
+ *
+ * const agent = new BuildShipAgent({
+ *   agentId: "your-agent-id",
+ *   accessKey: "your-access-key",
+ * });
+ *
+ * const session = await agent.execute("Hello!", {
+ *   onText: (text) => console.log(text),
+ *   onComplete: (fullText) => console.log("Done!", fullText),
+ * });
+ * ```
+ */
+declare class BuildShipAgent {
+    /** @internal */ readonly _agentId: string;
+    /** @internal */ readonly _accessKey?: string;
+    /** @internal */ readonly _baseUrl: string;
+    /** @internal */ readonly _clientTools: Map<string, ClientTool>;
+    constructor(config: AgentConfig);
+    /**
+     * The URL for the agent's execute endpoint.
+     * @internal
+     */
+    get _url(): string;
+    /**
+     * Build the authorization / common headers.
+     * @internal
+     */
+    _buildHeaders(sessionId?: SessionId): Record<string, string>;
+    /**
+     * Start a new conversation.
+     *
+     * Creates a fresh session and sends the first message.
+     *
+     * @param message  - The message to send
+     * @param callbacks - Event handlers for the stream
+     * @param context   - Optional additional context data
+     * @returns The new session
+     */
+    execute(message: string, callbacks: StreamCallbacks, context?: Record<string, any>): Promise<AgentSession>;
+    /**
+     * Get an existing session by ID to continue a conversation.
+     *
+     * @param sessionId - The session ID from a previous conversation
+     * @returns The session object
+     */
+    session(sessionId: SessionId | string): AgentSession;
+    /**
+     * Register a client-side tool that the agent can call.
+     */
+    registerClientTool(tool: ClientTool): void;
+    /**
+     * Remove a registered client tool.
+     */
+    unregisterClientTool(name: string): void;
+}
+
+/**
+ * Opens an SSE connection to the BuildShip agent endpoint using native
+ * `fetch` + `ReadableStream`, parses events, and dispatches to the
+ * appropriate callbacks.
+ *
+ * Zero runtime dependencies — works in both browser and Node.js.
+ *
+ * @internal
+ */
+declare function executeStream(options: StreamOptions): Promise<void>;
+
+export { AgentConfig, AgentSession, BuildShipAgent, ClientTool, PausedToolInfo, SessionId, StreamCallbacks, StreamOptions, executeStream };