@stigmer/runner 3.0.1

package/dist/client/stigmer-client.js

@@ -0,0 +1,239 @@
+/**
+ * Connect-RPC client for communicating with the Stigmer server.
+ *
+ * Provides typed wrappers around generated service stubs for RPCs the
+ * runner needs: execution queries, status updates, session reads/writes,
+ * and blueprint resolution (agent, skill, MCP server).
+ *
+ * Shared by all activities in the unified runner.
+ */
+import { createClient } from "@connectrpc/connect";
+import { createGrpcTransport } from "@connectrpc/connect-node";
+import { AgentExecutionCommandController } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/command_pb";
+import { AgentExecutionQueryController } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/query_pb";
+import { ExecutionContextQueryController } from "@stigmer/protos/ai/stigmer/agentic/executioncontext/v1/query_pb";
+import { SessionCommandController } from "@stigmer/protos/ai/stigmer/agentic/session/v1/command_pb";
+import { SessionQueryController } from "@stigmer/protos/ai/stigmer/agentic/session/v1/query_pb";
+import { AgentQueryController } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/query_pb";
+import { AgentInstanceQueryController } from "@stigmer/protos/ai/stigmer/agentic/agentinstance/v1/query_pb";
+import { McpServerQueryController } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/query_pb";
+import { McpServerCommandController } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/command_pb";
+import { ArtifactCommandController } from "@stigmer/protos/ai/stigmer/agentic/artifact/v1/command_pb";
+import { SkillQueryController } from "@stigmer/protos/ai/stigmer/agentic/skill/v1/query_pb";
+import { BillingCommandController } from "@stigmer/protos/ai/stigmer/billing/v1/command_pb";
+import { ExecutionContextExecutionIdInputSchema } from "@stigmer/protos/ai/stigmer/agentic/executioncontext/v1/io_pb";
+import { create } from "@bufbuild/protobuf";
+import { ConnectInputSchema } from "@stigmer/protos/ai/stigmer/agentic/mcpserver/v1/io_pb";
+import { ExecutionValueSchema } from "@stigmer/protos/ai/stigmer/agentic/executioncontext/v1/spec_pb";
+import { AgentExecutionUpdateStatusInputSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import { WorkflowExecutionCommandController } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/command_pb";
+import { WorkflowExecutionQueryController } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/query_pb";
+import { WorkflowExecutionUpdateStatusInputSchema, GetEventLogRequestSchema } from "@stigmer/protos/ai/stigmer/agentic/workflowexecution/v1/io_pb";
+import { WorkflowQueryController } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/query_pb";
+import { WorkflowInstanceQueryController } from "@stigmer/protos/ai/stigmer/agentic/workflowinstance/v1/query_pb";
+import { PlatformQueryController } from "@stigmer/protos/ai/stigmer/platform/v1/server_info_pb";
+import { assertCreateRequirements, assertReferenceRequirements } from "./server-contracts.js";
+export class StigmerClient {
+    transport;
+    currentToken;
+    executionQuery;
+    executionCommand;
+    executionContextQuery;
+    sessionQuery;
+    sessionCommand;
+    agentQuery;
+    agentInstanceQuery;
+    mcpServerQuery;
+    mcpServerCommand;
+    skillQuery;
+    billingCommand;
+    artifactCommand;
+    workflowExecutionCommand;
+    workflowExecutionQuery;
+    workflowQuery;
+    workflowInstanceQuery;
+    platformQuery;
+    tokenRef;
+    constructor(options) {
+        this.currentToken = options.token;
+        this.tokenRef = options.tokenRef ?? null;
+        this.transport = createGrpcTransport({
+            baseUrl: options.endpoint,
+            interceptors: [
+                (next) => async (req) => {
+                    const token = this.tokenRef?.current ?? this.currentToken;
+                    if (token) {
+                        req.header.set("authorization", `Bearer ${token}`);
+                    }
+                    return next(req);
+                },
+            ],
+        });
+        this.executionQuery = createClient(AgentExecutionQueryController, this.transport);
+        this.executionCommand = createClient(AgentExecutionCommandController, this.transport);
+        this.executionContextQuery = createClient(ExecutionContextQueryController, this.transport);
+        this.sessionQuery = createClient(SessionQueryController, this.transport);
+        this.sessionCommand = createClient(SessionCommandController, this.transport);
+        this.agentQuery = createClient(AgentQueryController, this.transport);
+        this.agentInstanceQuery = createClient(AgentInstanceQueryController, this.transport);
+        this.mcpServerQuery = createClient(McpServerQueryController, this.transport);
+        this.mcpServerCommand = createClient(McpServerCommandController, this.transport);
+        this.skillQuery = createClient(SkillQueryController, this.transport);
+        this.billingCommand = createClient(BillingCommandController, this.transport);
+        this.artifactCommand = createClient(ArtifactCommandController, this.transport);
+        this.workflowExecutionCommand = createClient(WorkflowExecutionCommandController, this.transport);
+        this.workflowExecutionQuery = createClient(WorkflowExecutionQueryController, this.transport);
+        this.workflowQuery = createClient(WorkflowQueryController, this.transport);
+        this.workflowInstanceQuery = createClient(WorkflowInstanceQueryController, this.transport);
+        this.platformQuery = createClient(PlatformQueryController, this.transport);
+    }
+    /**
+     * Fetch this runner's bootstrap config from the control plane.
+     *
+     * Lets an embedded runner self-bootstrap from a token alone: the control
+     * plane returns the Temporal frontend address and namespace for the
+     * environment the token belongs to (so integrators never hardcode
+     * infrastructure addresses) and, on cloud, a minted iss=stigmer access token
+     * the runner uses for its proxy traffic. The token fields are absent when the
+     * server does not mint one (OSS, or no signing key configured).
+     */
+    async getRunnerBootstrapConfig() {
+        const res = await this.platformQuery.getRunnerBootstrapConfig({});
+        return {
+            temporalAddress: res.temporalAddress,
+            temporalNamespace: res.temporalNamespace,
+            // Empty proto string/0 means "not minted" — normalize to undefined so
+            // callers branch on presence rather than emptiness.
+            runnerAccessToken: res.runnerAccessToken || undefined,
+            runnerAccessTokenExpiresInSeconds: res.runnerAccessTokenExpiresInSeconds || undefined,
+        };
+    }
+    async getExecution(executionId) {
+        return this.executionQuery.get({ value: executionId });
+    }
+    async updateStatus(executionId, status) {
+        const input = create(AgentExecutionUpdateStatusInputSchema, {
+            executionId,
+            status,
+        });
+        return this.executionCommand.updateStatus(input);
+    }
+    async getExecutionContextByExecutionId(executionId) {
+        return this.executionContextQuery.getByExecutionId(create(ExecutionContextExecutionIdInputSchema, { executionId }));
+    }
+    async getSession(sessionId) {
+        return this.sessionQuery.get({ value: sessionId });
+    }
+    async updateSession(session) {
+        return this.sessionCommand.update(session);
+    }
+    async getAgent(agentId) {
+        return this.agentQuery.get({ value: agentId });
+    }
+    async getAgentInstance(instanceId) {
+        return this.agentInstanceQuery.get({ value: instanceId });
+    }
+    async getMcpServer(serverId) {
+        return this.mcpServerQuery.get({ value: serverId });
+    }
+    async getMcpServerByReference(ref) {
+        return this.mcpServerQuery.getByReference(ref);
+    }
+    async connectMcpServer(mcpServerId, org, runtimeEnv) {
+        const input = create(ConnectInputSchema, {
+            mcpServerId,
+            org,
+        });
+        if (runtimeEnv) {
+            for (const [key, entry] of Object.entries(runtimeEnv)) {
+                input.runtimeEnv[key] = create(ExecutionValueSchema, {
+                    value: entry.value,
+                    isSecret: entry.isSecret,
+                });
+            }
+        }
+        return this.mcpServerCommand.connect(input);
+    }
+    async getSkill(skillId) {
+        return this.skillQuery.get({ value: skillId });
+    }
+    async getSkillByReference(ref) {
+        return this.skillQuery.getByReference(ref);
+    }
+    async getSkillArtifact(artifactStorageKey) {
+        return this.skillQuery.getArtifact({ artifactStorageKey });
+    }
+    async createArtifact(input) {
+        return this.artifactCommand.create(input);
+    }
+    async recordLlmCallUsage(input) {
+        return this.billingCommand.recordLlmCallUsage(input);
+    }
+    async getAgentByReference(ref) {
+        assertReferenceRequirements(ref, "Agent", "getAgentByReference");
+        return this.agentQuery.getByReference(ref);
+    }
+    async createSession(session) {
+        assertCreateRequirements(session, "Session", "createSession");
+        return this.sessionCommand.create(session);
+    }
+    async applySession(session) {
+        assertCreateRequirements(session, "Session", "applySession");
+        return this.sessionCommand.apply(session);
+    }
+    async createAgentExecution(execution) {
+        assertCreateRequirements(execution, "AgentExecution", "createAgentExecution");
+        return this.executionCommand.create(execution);
+    }
+    async updateWorkflowExecutionStatus(executionId, status, options) {
+        const input = create(WorkflowExecutionUpdateStatusInputSchema, {
+            executionId,
+            status,
+            updatePendingApprovals: options?.updatePendingApprovals ?? false,
+        });
+        return this.workflowExecutionCommand.updateStatus(input);
+    }
+    async getWorkflowExecution(executionId) {
+        return this.workflowExecutionQuery.get({ value: executionId });
+    }
+    /**
+     * Return the highest persisted event sequence_number for a workflow execution.
+     *
+     * Paginates through getEventLog with the maximum page size (500) and
+     * follows the cursor until has_more is false. The final page's
+     * latest_sequence is the global high-water mark.
+     *
+     * Returns 0 when no events have been persisted yet (new execution).
+     */
+    async getEventLogHighWaterMark(executionId) {
+        let afterSequence = BigInt(0);
+        let highWaterMark = BigInt(0);
+        for (;;) {
+            const resp = await this.workflowExecutionQuery.getEventLog(create(GetEventLogRequestSchema, {
+                executionId,
+                afterSequence,
+                pageSize: 500,
+            }));
+            if (resp.latestSequence > highWaterMark) {
+                highWaterMark = resp.latestSequence;
+            }
+            if (!resp.hasMore) {
+                return highWaterMark;
+            }
+            afterSequence = resp.latestSequence;
+        }
+    }
+    async getWorkflow(workflowId) {
+        return this.workflowQuery.get({ value: workflowId });
+    }
+    async getWorkflowVersion(workflowId, versionHash) {
+        return this.workflowQuery.getVersion({ workflowId, versionHash });
+    }
+    async getWorkflowInstance(instanceId) {
+        return this.workflowInstanceQuery.get({ value: instanceId });
+    }
+    updateToken(token) {
+        this.currentToken = token;
+    }
+}
+//# sourceMappingURL=stigmer-client.js.map

package/dist/client/stigmer-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stigmer-client.js","sourceRoot":"","sources":["../../src/client/stigmer-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAA+B,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,+BAA+B,EAAE,MAAM,iEAAiE,CAAC;AAClH,OAAO,EAAE,6BAA6B,EAAE,MAAM,+DAA+D,CAAC;AAC9G,OAAO,EAAE,+BAA+B,EAAE,MAAM,iEAAiE,CAAC;AAClH,OAAO,EAAE,wBAAwB,EAAE,MAAM,0DAA0D,CAAC;AACpG,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,MAAM,8DAA8D,CAAC;AAC5G,OAAO,EAAE,wBAAwB,EAAE,MAAM,0DAA0D,CAAC;AACpG,OAAO,EAAE,0BAA0B,EAAE,MAAM,4DAA4D,CAAC;AACxG,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AAGtG,OAAO,EAAE,oBAAoB,EAAE,MAAM,sDAAsD,CAAC;AAC5F,OAAO,EAAE,wBAAwB,EAAE,MAAM,kDAAkD,CAAC;AAI5F,OAAO,EAAE,sCAAsC,EAAE,MAAM,8DAA8D,CAAC;AAQtH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uDAAuD,CAAC;AAC3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,gEAAgE,CAAC;AACtG,OAAO,EAAE,qCAAqC,EAAE,MAAM,4DAA4D,CAAC;AAEnH,OAAO,EAAE,kCAAkC,EAAE,MAAM,oEAAoE,CAAC;AACxH,OAAO,EAAE,gCAAgC,EAAE,MAAM,kEAAkE,CAAC;AAEpH,OAAO,EAAE,wCAAwC,EAAE,wBAAwB,EAAE,MAAM,+DAA+D,CAAC;AACnJ,OAAO,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAElG,OAAO,EAAE,+BAA+B,EAAE,MAAM,iEAAiE,CAAC;AAElH,OAAO,EAAE,uBAAuB,EAAE,MAAM,uDAAuD,CAAC;AAChG,OAAO,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAmC9F,MAAM,OAAO,aAAa;IACf,SAAS,CAAY;IACtB,YAAY,CAAgB;IACnB,cAAc,CAA+C;IAC7D,gBAAgB,CAAiD;IACjE,qBAAqB,CAAiD;IACtE,YAAY,CAAwC;IACpD,cAAc,CAA0C;IACxD,UAAU,CAAsC;IAChD,kBAAkB,CAA8C;IAChE,cAAc,CAA0C;IACxD,gBAAgB,CAA4C;IAC5D,UAAU,CAAsC;IAChD,cAAc,CAA0C;IACxD,eAAe,CAA2C;IAClE,wBAAwB,CAAoD;IACpE,sBAAsB,CAAkD;IACxE,aAAa,CAAyC;IACtD,qBAAqB,CAAiD;IACtE,aAAa,CAAyC;IAEtD,QAAQ,CAAkB;IAE3C,YAAY,OAA6B;QACvC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,mBAAmB,CAAC;YACnC,OAAO,EAAE,OAAO,CAAC,QAAQ;YACzB,YAAY,EAAE;gBACZ,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;oBACtB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC;oBAC1D,IAAI,KAAK,EAAE,CAAC;wBACV,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,KAAK,EAAE,CAAC,CAAC;oBACrD,CAAC;oBACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;gBACnB,CAAC;aACF;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,GAAG,YAAY,CAAC,6BAA6B,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAClF,IAAI,CAAC,gBAAgB,GAAG,YAAY,CAAC,+BAA+B,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACtF,IAAI,CAAC,qBAAqB,GAAG,YAAY,CAAC,+BAA+B,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3F,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC,sBAAsB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACzE,IAAI,CAAC,cAAc,GAAG,YAAY,CAAC,wBAAwB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7E,IAAI,CAAC,UAAU,GAAG,YAAY,CAAC,oBAAoB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACrE,IAAI,CAAC,kBAAkB,GAAG,YAAY,CAAC,4BAA4B,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACrF,IAAI,CAAC,cAAc,GAAG,YAAY,CAAC,wBAAwB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7E,IAAI,CAAC,gBAAgB,GAAG,YAAY,CAAC,0BAA0B,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACjF,IAAI,CAAC,UAAU,GAAG,YAAY,CAAC,oBAAoB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACrE,IAAI,CAAC,cAAc,GAAG,YAAY,CAAC,wBAAwB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7E,IAAI,CAAC,eAAe,GAAG,YAAY,CAAC,yBAAyB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/E,IAAI,CAAC,wBAAwB,GAAG,YAAY,CAAC,kCAAkC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACjG,IAAI,CAAC,sBAAsB,GAAG,YAAY,CAAC,gCAAgC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7F,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC,uBAAuB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3E,IAAI,CAAC,qBAAqB,GAAG,YAAY,CAAC,+BAA+B,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3F,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC,uBAAuB,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,wBAAwB;QAC5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC;QAClE,OAAO;YACL,eAAe,EAAE,GAAG,CAAC,eAAe;YACpC,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;YACxC,sEAAsE;YACtE,oDAAoD;YACpD,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,IAAI,SAAS;YACrD,iCAAiC,EAC/B,GAAG,CAAC,iCAAiC,IAAI,SAAS;SACrD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,WAAmB;QACpC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,WAAmB,EACnB,MAA4B;QAE5B,MAAM,KAAK,GAAG,MAAM,CAAC,qCAAqC,EAAE;YAC1D,WAAW;YACX,MAAM;SACP,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,gCAAgC,CAAC,WAAmB;QACxD,OAAO,IAAI,CAAC,qBAAqB,CAAC,gBAAgB,CAChD,MAAM,CAAC,sCAAsC,EAAE,EAAE,WAAW,EAAE,CAAC,CAChE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAiB;QAChC,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAgB;QAClC,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,UAAkB;QACvC,OAAO,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAAgB;QACjC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,uBAAuB,CAAC,GAAyB;QACrD,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,WAAmB,EACnB,GAAW,EACX,UAAiE;QAEjE,MAAM,KAAK,GAAG,MAAM,CAAC,kBAAkB,EAAE;YACvC,WAAW;YACX,GAAG;SACJ,CAAC,CAAC;QACH,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBACtD,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,oBAAoB,EAAE;oBACnD,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;iBACzB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,GAAyB;QACjD,OAAO,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,kBAA0B;QAC/C,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAA0B;QAC7C,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,KAA8B;QACrD,OAAO,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,GAAyB;QACjD,2BAA2B,CAAC,GAAG,EAAE,OAAO,EAAE,qBAAqB,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAgB;QAClC,wBAAwB,CAAC,OAAO,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAgB;QACjC,wBAAwB,CAAC,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,SAAyB;QAClD,wBAAwB,CAAC,SAAS,EAAE,gBAAgB,EAAE,sBAAsB,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,6BAA6B,CACjC,WAAmB,EACnB,MAA+B,EAC/B,OAA8C;QAE9C,MAAM,KAAK,GAAG,MAAM,CAAC,wCAAwC,EAAE;YAC7D,WAAW;YACX,MAAM;YACN,sBAAsB,EAAE,OAAO,EAAE,sBAAsB,IAAI,KAAK;SACjE,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,wBAAwB,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,WAAmB;QAC5C,OAAO,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,wBAAwB,CAAC,WAAmB;QAChD,IAAI,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAE9B,SAAS,CAAC;YACR,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,WAAW,CACxD,MAAM,CAAC,wBAAwB,EAAE;gBAC/B,WAAW;gBACX,aAAa;gBACb,QAAQ,EAAE,GAAG;aACd,CAAC,CACH,CAAC;YAEF,IAAI,IAAI,CAAC,cAAc,GAAG,aAAa,EAAE,CAAC;gBACxC,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC;YACtC,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClB,OAAO,aAAa,CAAC;YACvB,CAAC;YAED,aAAa,GAAG,IAAI,CAAC,cAAc,CAAC;QACtC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,UAAkB;QAClC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,UAAkB,EAAE,WAAmB;QAC9D,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,UAAkB;QAC1C,OAAO,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,WAAW,CAAC,KAAoB;QAC9B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC5B,CAAC;CACF"}

package/dist/config.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Environment-based configuration for the unified runner service.
+ *
+ * Supports both ExecuteCursor and ExecuteDeepAgent activities from a single
+ * process. All values come from environment variables set by the CLI daemon,
+ * Kubernetes pod spec, or Daytona sandbox launcher.
+ *
+ * Credential modes:
+ *
+ * 1. Direct mode (local / OSS):
+ *    - CURSOR_API_KEY provided directly by the user (for Cursor harness).
+ *    - STIGMER_TOKEN is optional (local stigmer-server has no auth).
+ *    - STIGMER_PROXY_ENDPOINT is NOT set.
+ *
+ * 2. Proxy mode (cloud / managed runners):
+ *    - STIGMER_PROXY_ENDPOINT + STIGMER_TOKEN are required.
+ *    - CURSOR_API_KEY is NOT required — the proxy injects it.
+ *    - The fetch interceptor rewrites outbound Cursor SDK requests.
+ *
+ * Workspace isolation:
+ *
+ * WORKSPACE_ROOT_DIR must always resolve to a directory that is NOT the
+ * runner's own app directory. Falling back to process.cwd() would expose
+ * runner internals to agents. The fallback creates an isolated directory.
+ */
+export interface Config {
+    readonly taskQueue: string;
+    readonly temporalAddress: string;
+    readonly temporalNamespace: string;
+    readonly stigmerBackendEndpoint: string;
+    readonly stigmerToken: string | null;
+    /**
+     * Bearer credential for the Cursor SDK's Connect RPC transport.
+     *
+     * - Direct mode: the real Cursor API key (authenticates with Cursor directly).
+     * - Proxy mode: the STIGMER_TOKEN JWT (authenticates with our BiDi proxy,
+     *   which validates it and injects the real Cursor key upstream).
+     *
+     * Named after the CURSOR_API_KEY env var the SDK reads, though in proxy mode
+     * the credential authenticates with the proxy endpoint, not with Cursor.
+     */
+    readonly cursorApiKey: string;
+    readonly workspaceRootDir: string;
+    /**
+     * Execution location: where the agent runs and whose filesystem it sees.
+     * "local" allows local-path workspaces (host filesystem); "cloud" runs in a
+     * server-provisioned sandbox (git-only). Independent of {@link proxyEndpoint},
+     * which controls credential/artifact transport — the desktop runner executes
+     * locally yet still proxies its Cursor traffic.
+     */
+    readonly mode: "local" | "cloud";
+    readonly proxyEndpoint: string | null;
+    readonly maxConcurrentActivities: number;
+    readonly idleTimeoutSeconds: number | null;
+    readonly cloudModeEnabled: boolean;
+    readonly checkpointerType: "memory" | "http";
+    readonly checkpointerProxyEndpoint: string | null;
+    readonly primaryModel: string;
+    /** Shared mutable token reference for dynamic token updates (manager mode). */
+    readonly stigmerTokenRef?: {
+        current: string | null;
+    };
+}
+export declare function loadConfig(): Config;

package/dist/config.js

@@ -0,0 +1,123 @@
+/**
+ * Environment-based configuration for the unified runner service.
+ *
+ * Supports both ExecuteCursor and ExecuteDeepAgent activities from a single
+ * process. All values come from environment variables set by the CLI daemon,
+ * Kubernetes pod spec, or Daytona sandbox launcher.
+ *
+ * Credential modes:
+ *
+ * 1. Direct mode (local / OSS):
+ *    - CURSOR_API_KEY provided directly by the user (for Cursor harness).
+ *    - STIGMER_TOKEN is optional (local stigmer-server has no auth).
+ *    - STIGMER_PROXY_ENDPOINT is NOT set.
+ *
+ * 2. Proxy mode (cloud / managed runners):
+ *    - STIGMER_PROXY_ENDPOINT + STIGMER_TOKEN are required.
+ *    - CURSOR_API_KEY is NOT required — the proxy injects it.
+ *    - The fetch interceptor rewrites outbound Cursor SDK requests.
+ *
+ * Workspace isolation:
+ *
+ * WORKSPACE_ROOT_DIR must always resolve to a directory that is NOT the
+ * runner's own app directory. Falling back to process.cwd() would expose
+ * runner internals to agents. The fallback creates an isolated directory.
+ */
+import { mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir, tmpdir } from "node:os";
+export function loadConfig() {
+    const mode = (process.env.MODE ?? "local");
+    const proxyEndpoint = process.env.STIGMER_PROXY_ENDPOINT ?? null;
+    const proxyActive = !!proxyEndpoint;
+    const taskQueue = process.env.STIGMER_TASK_QUEUE
+        ?? process.env.TEMPORAL_AGENT_EXECUTION_RUNNER_TASK_QUEUE
+        ?? "stigmer_runner";
+    // Temporal address is no longer required up front. When unset, the runner
+    // self-discovers it from the control plane during boot (see bootstrap.ts):
+    // an explicit value always wins, a token triggers discovery, and a tokenless
+    // local runner falls back to localhost. An empty string here means "resolve
+    // later" — the factory fills it in before connecting to Temporal.
+    const temporalAddress = process.env.TEMPORAL_SERVICE_ADDRESS ?? "";
+    const temporalNamespace = process.env.TEMPORAL_NAMESPACE ?? "default";
+    const stigmerBackendEndpoint = normalizeEndpoint(mode === "local"
+        ? (process.env.STIGMER_BACKEND_ENDPOINT ?? "http://localhost:7234")
+        : requireEnv("STIGMER_BACKEND_ENDPOINT"));
+    const stigmerToken = (mode === "cloud" || proxyActive)
+        ? requireEnv("STIGMER_TOKEN")
+        : (process.env.STIGMER_TOKEN ?? null);
+    // In proxy mode, pass STIGMER_TOKEN as the SDK's API key. The SDK exchanges
+    // it (via REST proxy → Tomcat → Cursor) for an access token. The HTTP/2
+    // interceptor injects x-stigmer-auth for BiDi proxy authentication while
+    // the SDK's authorization header (Cursor access token) passes through to
+    // api2.cursor.sh unchanged.
+    const cursorApiKey = proxyActive
+        ? (process.env.CURSOR_API_KEY ?? stigmerToken ?? "proxy-managed")
+        : (process.env.CURSOR_API_KEY ?? "");
+    const workspaceRootDir = resolveWorkspaceRootDir();
+    const maxConcurrentActivities = parseInt(process.env.TEMPORAL_MAX_CONCURRENCY ?? "5", 10);
+    const idleTimeoutRaw = process.env.STIGMER_IDLE_TIMEOUT_SECONDS;
+    const idleTimeoutSeconds = idleTimeoutRaw ? parseInt(idleTimeoutRaw, 10) : null;
+    const checkpointerType = process.env.STIGMER_CHECKPOINTER_TYPE
+        ?? (mode === "cloud" ? "http" : "memory");
+    const checkpointerProxyEndpoint = process.env.STIGMER_CHECKPOINTER_PROXY_ENDPOINT
+        ?? proxyEndpoint;
+    const primaryModel = process.env.STIGMER_PRIMARY_MODEL ?? "gpt-4.1";
+    return {
+        taskQueue,
+        temporalAddress,
+        temporalNamespace,
+        stigmerBackendEndpoint,
+        stigmerToken,
+        cursorApiKey,
+        workspaceRootDir,
+        mode,
+        proxyEndpoint,
+        maxConcurrentActivities,
+        idleTimeoutSeconds,
+        cloudModeEnabled: process.env.STIGMER_CURSOR_CLOUD_MODE_ENABLED === "true",
+        checkpointerType,
+        checkpointerProxyEndpoint,
+        primaryModel,
+    };
+}
+function resolveWorkspaceRootDir() {
+    const explicit = process.env.WORKSPACE_ROOT_DIR;
+    if (explicit) {
+        return explicit;
+    }
+    console.warn("WORKSPACE_ROOT_DIR is not set — creating isolated fallback workspace. " +
+        "This likely means the runner was started outside the CLI daemon.");
+    const fallbackDir = safeWorkspaceFallback();
+    mkdirSync(fallbackDir, { recursive: true });
+    return fallbackDir;
+}
+function safeWorkspaceFallback() {
+    try {
+        return join(homedir(), ".stigmer", "workspaces", "runner");
+    }
+    catch {
+        return join(tmpdir(), "stigmer-runner-workspace");
+    }
+}
+function requireEnv(name) {
+    const value = process.env[name];
+    if (!value) {
+        throw new Error(`Required environment variable ${name} is not set`);
+    }
+    return value;
+}
+/**
+ * Ensures the endpoint has an HTTP(S) scheme. Port 443 implies TLS;
+ * all other bare host:port endpoints get http://.
+ */
+function normalizeEndpoint(endpoint) {
+    if (endpoint.startsWith("http://") || endpoint.startsWith("https://")) {
+        return endpoint;
+    }
+    if (endpoint.endsWith(":443")) {
+        return `https://${endpoint}`;
+    }
+    return `http://${endpoint}`;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/idle-watchdog.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Activity execution tracking for the execution worker.
+ *
+ * Tracks the number of concurrently executing Temporal activities and the
+ * timestamp of the last activity event. Used by activities for diagnostics
+ * and concurrency-aware behavior.
+ */
+export declare function activityStarted(): void;
+export declare function activityFinished(): void;
+export declare function getActiveCount(): number;
+export declare function getLastActivityAt(): number;

package/dist/idle-watchdog.js

@@ -0,0 +1,24 @@
+/**
+ * Activity execution tracking for the execution worker.
+ *
+ * Tracks the number of concurrently executing Temporal activities and the
+ * timestamp of the last activity event. Used by activities for diagnostics
+ * and concurrency-aware behavior.
+ */
+let lastActivityAt = Date.now();
+let activeCount = 0;
+export function activityStarted() {
+    activeCount++;
+    lastActivityAt = Date.now();
+}
+export function activityFinished() {
+    activeCount = Math.max(0, activeCount - 1);
+    lastActivityAt = Date.now();
+}
+export function getActiveCount() {
+    return activeCount;
+}
+export function getLastActivityAt() {
+    return lastActivityAt;
+}
+//# sourceMappingURL=idle-watchdog.js.map

package/dist/idle-watchdog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle-watchdog.js","sourceRoot":"","sources":["../src/idle-watchdog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,IAAI,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAChC,IAAI,WAAW,GAAG,CAAC,CAAC;AAEpB,MAAM,UAAU,eAAe;IAC7B,WAAW,EAAE,CAAC;IACd,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC;IAC3C,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @stigmer/runner — public API.
+ *
+ * Two modes of operation:
+ *
+ * 1. Static (CLI, single-queue polling):
+ *    {@link createStigmerRunner} — one Worker, one task queue, blocks until shutdown.
+ *
+ * 2. Dynamic (desktop, multi-session):
+ *    {@link createStigmerRunnerManager} — shared Temporal connection, per-session Workers.
+ *
+ * @example Static mode
+ * ```ts
+ * import { createStigmerRunner } from '@stigmer/runner';
+ *
+ * const runner = await createStigmerRunner({
+ *   taskQueue: 'agent_execution_runner',
+ *   temporalAddress: 'localhost:7233',
+ *   stigmerEndpoint: 'http://localhost:7234',
+ * });
+ *
+ * process.on('SIGTERM', () => runner.shutdown());
+ * await runner.start();
+ * ```
+ *
+ * @example Dynamic mode
+ * ```ts
+ * import { createStigmerRunnerManager } from '@stigmer/runner';
+ *
+ * const manager = await createStigmerRunnerManager({
+ *   temporalAddress: 'localhost:7233',
+ *   stigmerEndpoint: 'http://localhost:7234',
+ * });
+ *
+ * await manager.addSession('ses_abc123');
+ * // ... later
+ * await manager.shutdown();
+ * ```
+ */
+export { createStigmerRunner } from "./runner.js";
+export type { StigmerRunnerOptions, StigmerRunner } from "./runner.js";
+export { createStigmerRunnerManager } from "./runner-manager.js";
+export type { RunnerManagerOptions, StigmerRunnerManager, } from "./runner-manager.js";

package/dist/index.js

@@ -0,0 +1,42 @@
+/**
+ * @stigmer/runner — public API.
+ *
+ * Two modes of operation:
+ *
+ * 1. Static (CLI, single-queue polling):
+ *    {@link createStigmerRunner} — one Worker, one task queue, blocks until shutdown.
+ *
+ * 2. Dynamic (desktop, multi-session):
+ *    {@link createStigmerRunnerManager} — shared Temporal connection, per-session Workers.
+ *
+ * @example Static mode
+ * ```ts
+ * import { createStigmerRunner } from '@stigmer/runner';
+ *
+ * const runner = await createStigmerRunner({
+ *   taskQueue: 'agent_execution_runner',
+ *   temporalAddress: 'localhost:7233',
+ *   stigmerEndpoint: 'http://localhost:7234',
+ * });
+ *
+ * process.on('SIGTERM', () => runner.shutdown());
+ * await runner.start();
+ * ```
+ *
+ * @example Dynamic mode
+ * ```ts
+ * import { createStigmerRunnerManager } from '@stigmer/runner';
+ *
+ * const manager = await createStigmerRunnerManager({
+ *   temporalAddress: 'localhost:7233',
+ *   stigmerEndpoint: 'http://localhost:7234',
+ * });
+ *
+ * await manager.addSession('ses_abc123');
+ * // ... later
+ * await manager.shutdown();
+ * ```
+ */
+export { createStigmerRunner } from "./runner.js";
+export { createStigmerRunnerManager } from "./runner-manager.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/interceptors/workflow-metrics-sink.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Worker-side implementation of the workflow metrics sink.
+ *
+ * Receives timing data pushed from within the Temporal workflow sandbox
+ * and records it using the OTel metrics registry. This is the bridge
+ * between the deterministic workflow code and the non-deterministic
+ * observability infrastructure.
+ */
+import type { InjectedSinks } from "@temporalio/worker";
+import type { WorkflowMetricsSinks } from "../workflows/metrics-sink.js";
+export declare function createWorkflowMetricsSinks(): InjectedSinks<WorkflowMetricsSinks>;

package/dist/interceptors/workflow-metrics-sink.js

@@ -0,0 +1,51 @@
+/**
+ * Worker-side implementation of the workflow metrics sink.
+ *
+ * Receives timing data pushed from within the Temporal workflow sandbox
+ * and records it using the OTel metrics registry. This is the bridge
+ * between the deterministic workflow code and the non-deterministic
+ * observability infrastructure.
+ */
+import { getInstruments } from "../otel-metrics.js";
+let instrumentsPromise = null;
+function ensureInstruments() {
+    if (!instrumentsPromise) {
+        instrumentsPromise = getInstruments();
+    }
+    return instrumentsPromise;
+}
+export function createWorkflowMetricsSinks() {
+    return {
+        metrics: {
+            recordTaskDuration: {
+                fn(_workflowInfo, info) {
+                    ensureInstruments().then((instruments) => {
+                        const attrs = {
+                            "task.name": info.taskName,
+                            "task.kind": info.taskKind,
+                            "task.success": String(info.success),
+                        };
+                        instruments.workflowTaskDuration.record(info.durationMs, attrs);
+                        instruments.workflowTaskCount.add(1, attrs);
+                    });
+                },
+            },
+            recordExecutionStart: {
+                fn(_workflowInfo, info) {
+                    ensureInstruments().then((instruments) => {
+                        instruments.executionCount.add(1, { "workflow.name": info.workflowName });
+                        instruments.executionActive.add(1, { "workflow.name": info.workflowName });
+                    });
+                },
+            },
+            recordExecutionEnd: {
+                fn(_workflowInfo, info) {
+                    ensureInstruments().then((instruments) => {
+                        instruments.executionActive.add(-1, { "workflow.name": info.workflowName });
+                    });
+                },
+            },
+        },
+    };
+}
+//# sourceMappingURL=workflow-metrics-sink.js.map

package/dist/interceptors/workflow-metrics-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-metrics-sink.js","sourceRoot":"","sources":["../../src/interceptors/workflow-metrics-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,IAAI,kBAAkB,GAA6C,IAAI,CAAC;AAExE,SAAS,iBAAiB;IACxB,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,kBAAkB,GAAG,cAAc,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO;QACL,OAAO,EAAE;YACP,kBAAkB,EAAE;gBAClB,EAAE,CAAC,aAAa,EAAE,IAAI;oBACpB,iBAAiB,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;wBACvC,MAAM,KAAK,GAAG;4BACZ,WAAW,EAAE,IAAI,CAAC,QAAQ;4BAC1B,WAAW,EAAE,IAAI,CAAC,QAAQ;4BAC1B,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;yBACrC,CAAC;wBACF,WAAW,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;wBAChE,WAAW,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;oBAC9C,CAAC,CAAC,CAAC;gBACL,CAAC;aACF;YACD,oBAAoB,EAAE;gBACpB,EAAE,CAAC,aAAa,EAAE,IAAI;oBACpB,iBAAiB,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;wBACvC,WAAW,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;wBAC1E,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;oBAC7E,CAAC,CAAC,CAAC;gBACL,CAAC;aACF;YACD,kBAAkB,EAAE;gBAClB,EAAE,CAAC,aAAa,EAAE,IAAI;oBACpB,iBAAiB,EAAE,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;wBACvC,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;oBAC9E,CAAC,CAAC,CAAC;gBACL,CAAC;aACF;SACF;KACF,CAAC;AACJ,CAAC"}