@sekuire/sdk 0.1.12 → 0.1.13

package/dist/beacon.d.ts

@@ -70,6 +70,18 @@ export declare class Beacon {
      * Get current beacon status
      */
     getStatus(): BeaconStatus;
+    /**
+     * Get runtime credentials after successful bootstrap.
+     *
+     * Use this to share credentials with other components (e.g., TaskWorker)
+     * to avoid dual bootstrap token consumption.
+     *
+     * @returns Runtime credentials or null if not bootstrapped
+     */
+    getRuntimeCredentials(): {
+        installationId: string;
+        runtimeToken: string;
+    } | null;
     /**
      * Bootstrap with retry and exponential backoff
      *

package/dist/index.d.ts

@@ -75,6 +75,18 @@ declare class Beacon {
      * Get current beacon status
      */
     getStatus(): BeaconStatus;
+    /**
+     * Get runtime credentials after successful bootstrap.
+     *
+     * Use this to share credentials with other components (e.g., TaskWorker)
+     * to avoid dual bootstrap token consumption.
+     *
+     * @returns Runtime credentials or null if not bootstrapped
+     */
+    getRuntimeCredentials(): {
+        installationId: string;
+        runtimeToken: string;
+    } | null;
     /**
      * Bootstrap with retry and exponential backoff
      *
@@ -240,6 +252,120 @@ declare class SekuireLogger {
     setEnabled(enabled: boolean): void;
 }
 
+/**
+ * Sekuire Task Worker
+ *
+ * Handles SSE connection to Core for real-time task delivery.
+ * Provides `onTask()` API for agents to register task handlers.
+ */
+interface TaskEvent {
+    task_id: string;
+    capability?: string;
+    tool?: string;
+    input: Record<string, unknown>;
+    workspace_id: string;
+    requester_agent_id?: string;
+    parent_task_id?: string;
+    trace_id?: string;
+    workflow_id?: string;
+}
+interface TaskContext {
+    taskId: string;
+    workspaceId: string;
+    requesterId?: string;
+    parentTaskId?: string;
+    traceId?: string;
+    workflowId?: string;
+}
+type TaskHandler = (ctx: TaskContext, input: Record<string, unknown>) => Promise<unknown>;
+interface WorkerConfig {
+    apiBaseUrl: string;
+    agentId: string;
+    installToken?: string;
+    runtimeToken?: string;
+    heartbeatIntervalMs?: number;
+    reconnectDelayMs?: number;
+    maxReconnectDelayMs?: number;
+    deploymentUrl?: string;
+    capabilities?: string[];
+}
+declare class TaskWorker {
+    private eventSource;
+    private handlers;
+    private config;
+    private heartbeatInterval;
+    private reconnectDelay;
+    private isConnected;
+    private isPaused;
+    private installationId;
+    private runtimeToken;
+    private refreshToken;
+    private expiresAt;
+    private onCommandCallback?;
+    constructor(config: WorkerConfig);
+    /**
+     * Register a handler for a specific capability
+     */
+    onTask(capability: string, handler: TaskHandler): this;
+    /**
+     * Start the worker (connects to SSE stream and starts heartbeat)
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the worker gracefully
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if the worker is currently paused
+     */
+    getIsPaused(): boolean;
+    /**
+     * Register a callback for control commands
+     */
+    onCommand(callback: (cmd: {
+        type: string;
+        reason?: string;
+    }) => void): this;
+    /**
+     * Handle control commands from SSE or heartbeat fallback
+     */
+    private handleCommand;
+    /**
+     * Get runtime token for API calls
+     */
+    private getToken;
+    /**
+     * Connect to SSE stream
+     */
+    private connect;
+    /**
+     * Schedule reconnection with exponential backoff
+     */
+    private scheduleReconnect;
+    /**
+     * Handle incoming task
+     */
+    private handleTask;
+    /**
+     * Report task completion to Core
+     */
+    private completeTask;
+    /**
+     * Register this agent installation with Sekuire using install_token
+     * Returns runtime_token for subsequent API calls
+     */
+    private bootstrap;
+    /**
+     * Start heartbeat/lease renewal loop
+     */
+    private startHeartbeat;
+    /**
+     * Refresh the runtime token using the refresh token
+     */
+    private refreshRuntimeToken;
+}
+declare function createWorker(config: WorkerConfig): TaskWorker;
+
 /**
  * SekuireSDK - Main SDK entry point for TypeScript agents
  *
@@ -330,6 +456,47 @@ declare class SekuireSDK {
      * Get the current beacon status (heartbeat health, connection info).
      */
     getBeaconStatus(): BeaconStatus;
+    /**
+     * Get runtime credentials after SDK has started.
+     *
+     * Use this to share credentials with TaskWorker to avoid dual bootstrap
+     * token consumption. The SDK must be started first.
+     *
+     * @returns Runtime credentials or null if not bootstrapped
+     */
+    getRuntimeCredentials(): {
+        installationId: string;
+        runtimeToken: string;
+    } | null;
+    /**
+     * Create a TaskWorker that shares credentials with this SDK instance.
+     *
+     * This avoids the dual bootstrap token consumption issue by reusing
+     * the runtime credentials from the SDK's beacon. The SDK must be started
+     * before calling this method.
+     *
+     * @param options Optional worker configuration overrides
+     * @returns TaskWorker instance ready to be started
+     * @throws Error if SDK hasn't been started or bootstrap failed
+     *
+     * @example
+     * ```ts
+     * const sdk = new SekuireSDK({ ... });
+     * await sdk.start();
+     *
+     * const worker = sdk.createTaskWorker();
+     * worker.onTask("my-capability", async (ctx, input) => {
+     *   return { result: "done" };
+     * });
+     * await worker.start();
+     * ```
+     */
+    createTaskWorker(options?: {
+        heartbeatIntervalMs?: number;
+        reconnectDelayMs?: number;
+        maxReconnectDelayMs?: number;
+        capabilities?: string[];
+    }): TaskWorker;
     /**
      * Get the agent ID.
      */
@@ -2586,120 +2753,6 @@ declare function calculateSekuireId(params: {
  */
 declare function createSekuireClient(keyPair: KeyPair, registryUrl?: string, options?: Partial<SekuireClientConfig>): SekuireClient;
 
-/**
- * Sekuire Task Worker
- *
- * Handles SSE connection to Core for real-time task delivery.
- * Provides `onTask()` API for agents to register task handlers.
- */
-interface TaskEvent {
-    task_id: string;
-    capability?: string;
-    tool?: string;
-    input: Record<string, unknown>;
-    workspace_id: string;
-    requester_agent_id?: string;
-    parent_task_id?: string;
-    trace_id?: string;
-    workflow_id?: string;
-}
-interface TaskContext {
-    taskId: string;
-    workspaceId: string;
-    requesterId?: string;
-    parentTaskId?: string;
-    traceId?: string;
-    workflowId?: string;
-}
-type TaskHandler = (ctx: TaskContext, input: Record<string, unknown>) => Promise<unknown>;
-interface WorkerConfig {
-    apiBaseUrl: string;
-    agentId: string;
-    installToken?: string;
-    runtimeToken?: string;
-    heartbeatIntervalMs?: number;
-    reconnectDelayMs?: number;
-    maxReconnectDelayMs?: number;
-    deploymentUrl?: string;
-    capabilities?: string[];
-}
-declare class TaskWorker {
-    private eventSource;
-    private handlers;
-    private config;
-    private heartbeatInterval;
-    private reconnectDelay;
-    private isConnected;
-    private isPaused;
-    private installationId;
-    private runtimeToken;
-    private refreshToken;
-    private expiresAt;
-    private onCommandCallback?;
-    constructor(config: WorkerConfig);
-    /**
-     * Register a handler for a specific capability
-     */
-    onTask(capability: string, handler: TaskHandler): this;
-    /**
-     * Start the worker (connects to SSE stream and starts heartbeat)
-     */
-    start(): Promise<void>;
-    /**
-     * Stop the worker gracefully
-     */
-    stop(): Promise<void>;
-    /**
-     * Check if the worker is currently paused
-     */
-    getIsPaused(): boolean;
-    /**
-     * Register a callback for control commands
-     */
-    onCommand(callback: (cmd: {
-        type: string;
-        reason?: string;
-    }) => void): this;
-    /**
-     * Handle control commands from SSE or heartbeat fallback
-     */
-    private handleCommand;
-    /**
-     * Get runtime token for API calls
-     */
-    private getToken;
-    /**
-     * Connect to SSE stream
-     */
-    private connect;
-    /**
-     * Schedule reconnection with exponential backoff
-     */
-    private scheduleReconnect;
-    /**
-     * Handle incoming task
-     */
-    private handleTask;
-    /**
-     * Report task completion to Core
-     */
-    private completeTask;
-    /**
-     * Register this agent installation with Sekuire using install_token
-     * Returns runtime_token for subsequent API calls
-     */
-    private bootstrap;
-    /**
-     * Start heartbeat/lease renewal loop
-     */
-    private startHeartbeat;
-    /**
-     * Refresh the runtime token using the refresh token
-     */
-    private refreshRuntimeToken;
-}
-declare function createWorker(config: WorkerConfig): TaskWorker;
-
 interface SekuireExporterConfig {
     apiUrl: string;
     agentId: string;