pulseed 0.6.4 → 0.6.6

package/dist/interface/chat/chat-state-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-state-service.d.ts","sourceRoot":"","sources":["../../../src/interface/chat/chat-state-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,YAAY;IAEjD,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAMlC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE;IAI5B,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IASnC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAIjD,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,IAAI,CAAC,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,IAAI,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IA+BrE,yBAAyB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAiBjE,YAAY,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM;IAOnD,OAAO,CAAC,qBAAqB;CAG9B"}
+{"version":3,"file":"chat-state-service.d.ts","sourceRoot":"","sources":["../../../src/interface/chat/chat-state-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,YAAY;IAEjD,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAMlC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE;IAI5B,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAQnC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAIjD,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,IAAI,CAAC,EAAE,IAAI,CAAC;QAAC,OAAO,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,IAAI,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IA+BrE,yBAAyB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAiBjE,YAAY,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM;IAOnD,OAAO,CAAC,qBAAqB;CAG9B"}

package/dist/interface/chat/chat-state-service.js

@@ -14,12 +14,11 @@ export class ChatStateService {
         return goals.filter((goal) => goal.status === "active" || goal.status === "waiting" || goal.loop_status === "running");
     }
     async listAllGoalIds() {
-        const [activeIds, archivedIds, recoverableArchivedIds] = await Promise.all([
+        const [activeIds, archivedIds] = await Promise.all([
             this.stateManager.listGoalIds(),
             this.stateManager.listArchivedGoals(),
-            this.stateManager.listRecoverableArchivedGoalIds(),
         ]);
-        return [...new Set([...activeIds, ...archivedIds, ...recoverableArchivedIds])];
+        return [...new Set([...activeIds, ...archivedIds])];
     }
     async readTasksForGoal(goalId) {
         return this.stateManager.listTasks(goalId);

package/dist/interface/chat/chat-state-service.js.map

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

package/dist/interface/chat/chat-usage-contracts.d.ts

@@ -0,0 +1,102 @@
+import { z } from "zod";
+export declare const ChatUsageCounterSchema: z.ZodObject<{
+    inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type ChatUsageCounter = z.infer<typeof ChatUsageCounterSchema>;
+export declare const ChatSessionUsageSchema: z.ZodObject<{
+    totals: z.ZodDefault<z.ZodObject<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    byPhase: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    totals: z.ZodDefault<z.ZodObject<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    byPhase: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    totals: z.ZodDefault<z.ZodObject<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    byPhase: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        inputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        outputTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+        totalTokens: z.ZodCatch<z.ZodEffects<z.ZodNumber, number, number>>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export type ChatSessionUsage = z.infer<typeof ChatSessionUsageSchema>;
+//# sourceMappingURL=chat-usage-contracts.d.ts.map

package/dist/interface/chat/chat-usage-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-usage-contracts.d.ts","sourceRoot":"","sources":["../../../src/interface/chat/chat-usage-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;gCAInB,CAAC;AACjB,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAQnB,CAAC;AACjB,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/interface/chat/chat-usage-contracts.js

@@ -0,0 +1,17 @@
+import { z } from "zod";
+const ChatUsageTokenCountSchema = z.number().int().nonnegative().refine(Number.isSafeInteger).catch(0);
+export const ChatUsageCounterSchema = z.object({
+    inputTokens: ChatUsageTokenCountSchema,
+    outputTokens: ChatUsageTokenCountSchema,
+    totalTokens: ChatUsageTokenCountSchema,
+}).passthrough();
+export const ChatSessionUsageSchema = z.object({
+    totals: ChatUsageCounterSchema.default({
+        inputTokens: 0,
+        outputTokens: 0,
+        totalTokens: 0,
+    }),
+    byPhase: z.record(ChatUsageCounterSchema).default({}),
+    updatedAt: z.string().optional(),
+}).passthrough();
+//# sourceMappingURL=chat-usage-contracts.js.map

package/dist/interface/chat/chat-usage-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-usage-contracts.js","sourceRoot":"","sources":["../../../src/interface/chat/chat-usage-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEvG,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,WAAW,EAAE,yBAAyB;IACtC,YAAY,EAAE,yBAAyB;IACvC,WAAW,EAAE,yBAAyB;CACvC,CAAC,CAAC,WAAW,EAAE,CAAC;AAGjB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,sBAAsB,CAAC,OAAO,CAAC;QACrC,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,CAAC;KACf,CAAC;IACF,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACrD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC,WAAW,EAAE,CAAC"}

package/dist/interface/chat/chat-usage.d.ts

@@ -0,0 +1,12 @@
+import type { LLMResponse } from "../../base/llm/llm-client.js";
+import type { ChatSessionUsage, ChatUsageCounter } from "./chat-usage-contracts.js";
+export declare function zeroUsageCounter(): ChatUsageCounter;
+export declare function addTokenCounts(left: number, right: number): number;
+export declare function normalizeUsageCounter(usage: ChatUsageCounter): ChatUsageCounter;
+export declare function sumUsageCounters(base: ChatUsageCounter | undefined, delta: ChatUsageCounter): ChatUsageCounter;
+export declare function normalizeSessionUsage(usage: ChatSessionUsage): ChatSessionUsage;
+export declare function addUsageCounter(target: ChatUsageCounter, delta: ChatUsageCounter): void;
+export declare function usageFromLLMResponse(response: LLMResponse): ChatUsageCounter;
+export declare function hasUsage(usage: ChatUsageCounter): boolean;
+export declare function formatUsageCounter(prefix: string, usage: ChatUsageCounter): string[];
+//# sourceMappingURL=chat-usage.d.ts.map

package/dist/interface/chat/chat-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-usage.d.ts","sourceRoot":"","sources":["../../../src/interface/chat/chat-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAYpF,wBAAgB,gBAAgB,IAAI,gBAAgB,CAEnD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAE/E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAAE,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAE9G;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAW/E;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAEvF;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,GAAG,gBAAgB,CAI5E;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAEzD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAEpF"}

package/dist/interface/chat/chat-usage.js

@@ -0,0 +1,38 @@
+import { addUsageCounter as addSharedUsageCounter, addUsageTokenCounts, formatUsageCounter as formatSharedUsageCounter, hasUsage as hasSharedUsage, normalizeUsageCounter as normalizeSharedUsageCounter, parseUsageTokenCount, sumUsageCounters as sumSharedUsageCounters, zeroUsageCounter as zeroSharedUsageCounter, } from "../usage-counter.js";
+export function zeroUsageCounter() {
+    return zeroSharedUsageCounter();
+}
+export function addTokenCounts(left, right) {
+    return addUsageTokenCounts(left, right);
+}
+export function normalizeUsageCounter(usage) {
+    return normalizeSharedUsageCounter(usage);
+}
+export function sumUsageCounters(base, delta) {
+    return sumSharedUsageCounters(base, delta);
+}
+export function normalizeSessionUsage(usage) {
+    return {
+        totals: normalizeUsageCounter((usage.totals ?? zeroUsageCounter())),
+        byPhase: Object.fromEntries(Object.entries(usage.byPhase ?? {}).map(([phase, counter]) => [
+            phase,
+            normalizeUsageCounter(counter),
+        ])),
+        ...(usage.updatedAt ? { updatedAt: usage.updatedAt } : {}),
+    };
+}
+export function addUsageCounter(target, delta) {
+    addSharedUsageCounter(target, delta);
+}
+export function usageFromLLMResponse(response) {
+    const inputTokens = parseUsageTokenCount(response.usage?.input_tokens) ?? 0;
+    const outputTokens = parseUsageTokenCount(response.usage?.output_tokens) ?? 0;
+    return { inputTokens, outputTokens, totalTokens: addTokenCounts(inputTokens, outputTokens) };
+}
+export function hasUsage(usage) {
+    return hasSharedUsage(usage);
+}
+export function formatUsageCounter(prefix, usage) {
+    return formatSharedUsageCounter(prefix, usage);
+}
+//# sourceMappingURL=chat-usage.js.map

package/dist/interface/chat/chat-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-usage.js","sourceRoot":"","sources":["../../../src/interface/chat/chat-usage.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,eAAe,IAAI,qBAAqB,EACxC,mBAAmB,EACnB,kBAAkB,IAAI,wBAAwB,EAC9C,QAAQ,IAAI,cAAc,EAC1B,qBAAqB,IAAI,2BAA2B,EACpD,oBAAoB,EACpB,gBAAgB,IAAI,sBAAsB,EAC1C,gBAAgB,IAAI,sBAAsB,GAC3C,MAAM,qBAAqB,CAAC;AAE7B,MAAM,UAAU,gBAAgB;IAC9B,OAAO,sBAAsB,EAAsB,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAa;IACxD,OAAO,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAuB;IAC3D,OAAO,2BAA2B,CAAC,KAAK,CAAqB,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAkC,EAAE,KAAuB;IAC1F,OAAO,sBAAsB,CAAC,IAAI,EAAE,KAAK,CAAqB,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAuB;IAC3D,OAAO;QACL,MAAM,EAAE,qBAAqB,CAAC,CAAC,KAAK,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAAqB,CAAC;QACvF,OAAO,EAAE,MAAM,CAAC,WAAW,CACzB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;YAC5D,KAAK;YACL,qBAAqB,CAAC,OAA2B,CAAC;SACnD,CAAC,CACH;QACD,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAwB,EAAE,KAAuB;IAC/E,qBAAqB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAqB;IACxD,MAAM,WAAW,GAAG,oBAAoB,CAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5E,MAAM,YAAY,GAAG,oBAAoB,CAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IAC9E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,CAAC;AAC/F,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAuB;IAC9C,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,KAAuB;IACxE,OAAO,wBAAwB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC"}

package/dist/interface/chat/cross-platform-session-normalization.d.ts

@@ -0,0 +1,50 @@
+import { type ExternalSurfaceDecision } from "../../runtime/gateway/channel-policy.js";
+import type { RuntimeControlActor } from "../../runtime/store/runtime-operation-schemas.js";
+import type { ChatIngressChannel, ChatIngressReplyTarget, ChatIngressRuntimeControl } from "./ingress-router.js";
+export interface CrossPlatformSessionKeyParts {
+    identity_key?: string;
+    platform?: string;
+    conversation_id?: string;
+    user_id?: string;
+}
+export interface CrossPlatformSessionMetadataInput {
+    metadata?: Record<string, unknown>;
+    platform?: string;
+    conversation_id?: string;
+    conversation_name?: string;
+    user_id?: string;
+    user_name?: string;
+    channel?: ChatIngressChannel;
+}
+export declare function normalizeIdentity(value: string | undefined): string | null;
+export declare function normalizePlatform(value: string | undefined): string | null;
+export declare function buildSessionKeyFromParts(params: CrossPlatformSessionKeyParts): string;
+export declare function cloneMetadata(metadata: Record<string, unknown> | undefined): Record<string, unknown>;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function cloneReplyTarget(target: Record<string, unknown> | ChatIngressReplyTarget): ChatIngressReplyTarget;
+export declare function stringField(value: Record<string, unknown> | undefined, field: string): string | undefined;
+export declare function buildSessionMetadata(options: CrossPlatformSessionMetadataInput): Record<string, unknown>;
+export declare function resolveChannel(input: {
+    channel?: ChatIngressChannel;
+    platform?: string;
+}): ChatIngressChannel;
+export declare function resolveActorSurface(channel: ChatIngressChannel): RuntimeControlActor["surface"];
+export declare function resolveRuntimeControl(channel: ChatIngressChannel, runtimeControl: Partial<ChatIngressRuntimeControl> | undefined, metadata: Record<string, unknown> | undefined, externalSurface: ExternalSurfaceDecision | undefined): ChatIngressRuntimeControl;
+export declare function normalizeReplyTarget(channel: ChatIngressChannel, input: {
+    platform?: string;
+    conversation_id?: string;
+    identity_key?: string;
+    user_id?: string;
+    message_id?: string;
+    replyTarget?: Partial<ChatIngressReplyTarget>;
+    metadata?: Record<string, unknown>;
+    externalSurface?: ExternalSurfaceDecision;
+}): ChatIngressReplyTarget;
+export declare function normalizeActor(channel: ChatIngressChannel, input: {
+    platform?: string;
+    conversation_id?: string;
+    identity_key?: string;
+    user_id?: string;
+    actor?: Partial<RuntimeControlActor>;
+}): RuntimeControlActor;
+//# sourceMappingURL=cross-platform-session-normalization.d.ts.map

package/dist/interface/chat/cross-platform-session-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-platform-session-normalization.d.ts","sourceRoot":"","sources":["../../../src/interface/chat/cross-platform-session-normalization.ts"],"names":[],"mappings":"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"}

package/dist/interface/chat/cross-platform-session-normalization.js

@@ -0,0 +1,134 @@
+import { randomUUID } from "node:crypto";
+import { EXTERNAL_SURFACE_METADATA_KEY, } from "../../runtime/gateway/channel-policy.js";
+export function normalizeIdentity(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : null;
+}
+export function normalizePlatform(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed.toLowerCase() : null;
+}
+export function buildSessionKeyFromParts(params) {
+    const identityKey = normalizeIdentity(params.identity_key);
+    if (identityKey) {
+        return `identity:${identityKey}`;
+    }
+    const platform = normalizePlatform(params.platform);
+    const conversationId = normalizeIdentity(params.conversation_id);
+    if (platform && conversationId) {
+        return `platform:${platform}:conversation:${conversationId}`;
+    }
+    const userId = normalizeIdentity(params.user_id);
+    if (platform && userId) {
+        return `platform:${platform}:user:${userId}`;
+    }
+    return `ephemeral:${randomUUID()}`;
+}
+export function cloneMetadata(metadata) {
+    return metadata ? { ...metadata } : {};
+}
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function cloneReplyTarget(target) {
+    return {
+        ...target,
+        metadata: isRecord(target.metadata) ? cloneMetadata(target.metadata) : {},
+    };
+}
+export function stringField(value, field) {
+    const fieldValue = value?.[field];
+    return typeof fieldValue === "string" && fieldValue.trim() ? fieldValue : undefined;
+}
+export function buildSessionMetadata(options) {
+    return {
+        ...(options.metadata ?? {}),
+        ...(options.channel ? { channel: options.channel } : {}),
+        ...(options.platform ? { platform: options.platform } : {}),
+        ...(options.conversation_id ? { conversation_id: options.conversation_id } : {}),
+        ...(options.conversation_name ? { conversation_name: options.conversation_name } : {}),
+        ...(options.user_id ? { user_id: options.user_id } : {}),
+        ...(options.user_name ? { user_name: options.user_name } : {}),
+    };
+}
+export function resolveChannel(input) {
+    if (input.channel)
+        return input.channel;
+    return input.platform ? "plugin_gateway" : "cli";
+}
+export function resolveActorSurface(channel) {
+    switch (channel) {
+        case "plugin_gateway":
+            return "gateway";
+        case "cli":
+            return "cli";
+        case "tui":
+            return "tui";
+        default:
+            return "chat";
+    }
+}
+export function resolveRuntimeControl(channel, runtimeControl, metadata, externalSurface) {
+    const surfacePreapproved = externalSurface?.runtime_control_policy.allowed === true
+        && externalSurface.runtime_control_policy.approval_mode === "preapproved";
+    const surfaceDenied = externalSurface?.runtime_control_policy.approval_mode === "disallowed";
+    const approvalMode = runtimeControl?.approvalMode
+        ?? (externalSurface
+            ? surfacePreapproved ? "preapproved" : "disallowed"
+            : metadata?.["runtime_control_approved"] === true
+                ? "preapproved"
+                : surfaceDenied || metadata?.["runtime_control_denied"] === true
+                    ? "disallowed"
+                    : channel === "tui" || channel === "cli"
+                        ? "interactive"
+                        : "disallowed");
+    return {
+        allowed: runtimeControl?.allowed ?? approvalMode !== "disallowed",
+        approvalMode,
+        ...(runtimeControl?.explicit === true ? { explicit: true } : {}),
+    };
+}
+export function normalizeReplyTarget(channel, input) {
+    const platform = normalizePlatform(input.replyTarget?.platform ?? input.platform) ?? undefined;
+    const conversationId = normalizeIdentity(input.replyTarget?.conversation_id ?? input.conversation_id) ?? undefined;
+    const identityKey = normalizeIdentity(input.replyTarget?.identity_key ?? input.identity_key) ?? undefined;
+    const userId = normalizeIdentity(input.replyTarget?.user_id ?? input.user_id) ?? undefined;
+    const messageId = normalizeIdentity(input.replyTarget?.message_id ?? input.message_id) ?? undefined;
+    const metadata = {
+        ...(input.metadata ?? {}),
+        ...(input.replyTarget?.metadata ?? {}),
+        ...(input.externalSurface ? { [EXTERNAL_SURFACE_METADATA_KEY]: input.externalSurface } : {}),
+    };
+    if (input.externalSurface) {
+        delete metadata["notification_route_id"];
+    }
+    else {
+        delete metadata[EXTERNAL_SURFACE_METADATA_KEY];
+    }
+    return {
+        surface: input.replyTarget?.surface ?? resolveActorSurface(channel),
+        ...(platform ? { platform } : {}),
+        ...(conversationId ? { conversation_id: conversationId } : {}),
+        ...(identityKey ? { identity_key: identityKey } : {}),
+        ...(userId ? { user_id: userId } : {}),
+        ...(messageId ? { message_id: messageId } : {}),
+        deliveryMode: input.replyTarget?.deliveryMode ?? "reply",
+        ...input.replyTarget,
+        metadata,
+    };
+}
+export function normalizeActor(channel, input) {
+    const platform = normalizePlatform(input.actor?.platform ?? input.platform) ?? undefined;
+    const conversationId = normalizeIdentity(input.actor?.conversation_id ?? input.conversation_id) ?? undefined;
+    const identityKey = normalizeIdentity(input.actor?.identity_key ?? input.identity_key) ?? undefined;
+    const userId = normalizeIdentity(input.actor?.user_id ?? input.user_id) ?? undefined;
+    return {
+        surface: input.actor?.surface ?? resolveActorSurface(channel),
+        ...(platform ? { platform } : {}),
+        ...(conversationId ? { conversation_id: conversationId } : {}),
+        ...(identityKey ? { identity_key: identityKey } : {}),
+        ...(userId ? { user_id: userId } : {}),
+        ...input.actor,
+    };
+}
+//# sourceMappingURL=cross-platform-session-normalization.js.map

package/dist/interface/chat/cross-platform-session-normalization.js.map

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

package/dist/interface/chat/cross-platform-session-types.d.ts

@@ -0,0 +1,105 @@
+import type { ChatIngressChannel, ChatIngressMessage, ChatIngressReplyTarget, ChatIngressRuntimeControl } from "./ingress-types.js";
+import type { CompanionPresenceState, CompanionRuntimeContract, CompanionTurnPolicy, ConversationInputModality, ConversationOutputMode } from "../../runtime/types/companion.js";
+import type { RuntimeControlActor } from "../../runtime/store/runtime-operation-schemas.js";
+import type { ExternalSurfaceDecision } from "../../runtime/gateway/channel-policy.js";
+import type { ChatEventHandler } from "./chat-events.js";
+import type { UserInput } from "./user-input.js";
+export interface CrossPlatformChatSessionOptions {
+    /**
+     * Stable cross-platform join key.
+     * When present, sessions with the same identity_key share one ChatRunner session.
+     */
+    identity_key?: string;
+    /** Platform or transport name, e.g. "slack", "discord", "web". */
+    platform?: string;
+    /** Conversation/thread identifier on the transport. */
+    conversation_id?: string;
+    /** Human-readable conversation title or thread name. */
+    conversation_name?: string;
+    /** User identifier on the transport. */
+    user_id?: string;
+    /** Human-readable user name. */
+    user_name?: string;
+    /** Channel family for ingress normalization. */
+    channel?: ChatIngressChannel;
+    /** Optional per-turn message id from the transport. */
+    message_id?: string;
+    /** Optional goal selected by gateway routing for this turn. */
+    goal_id?: string;
+    /** Explicit typed actor override for routing/runtime control. */
+    actor?: Partial<RuntimeControlActor>;
+    /** Explicit reply target override for outbound routing. */
+    replyTarget?: Partial<ChatIngressReplyTarget>;
+    /** Explicit runtime-control policy for the turn. */
+    runtimeControl?: Partial<ChatIngressRuntimeControl>;
+    /** Typed external surface policy attached by gateway/channel ingress. */
+    externalSurface?: ExternalSurfaceDecision;
+    /** Shared companion presence/policy contract overrides for this turn. */
+    companion?: {
+        presence?: Partial<CompanionPresenceState>;
+        turnPolicy?: Partial<CompanionTurnPolicy>;
+        inputModality?: ConversationInputModality;
+        outputMode?: ConversationOutputMode;
+    };
+    /** Workspace root or working directory used when the session is created. */
+    cwd?: string;
+    /** Per-turn timeout forwarded to ChatRunner. */
+    timeoutMs?: number;
+    /** Extra transport metadata for plugins to retain alongside the session. */
+    metadata?: Record<string, unknown>;
+    /** Optional streaming callback for ChatEvent updates. */
+    onEvent?: ChatEventHandler;
+    /** Canonical typed user input. If omitted, text is preserved as one text item. */
+    userInput?: UserInput;
+}
+export interface CrossPlatformIncomingChatMessage {
+    text: string;
+    userInput?: UserInput;
+    channel?: ChatIngressChannel;
+    identity_key?: string;
+    platform?: string;
+    conversation_id?: string;
+    conversation_name?: string;
+    sender_id?: string;
+    user_id?: string;
+    user_name?: string;
+    message_id?: string;
+    goal_id?: string;
+    cwd?: string;
+    timeoutMs?: number;
+    actor?: Partial<RuntimeControlActor>;
+    replyTarget?: Partial<ChatIngressReplyTarget>;
+    runtimeControl?: Partial<ChatIngressRuntimeControl>;
+    externalSurface?: ExternalSurfaceDecision;
+    companion?: {
+        presence?: Partial<CompanionPresenceState>;
+        turnPolicy?: Partial<CompanionTurnPolicy>;
+        inputModality?: ConversationInputModality;
+        outputMode?: ConversationOutputMode;
+    };
+    metadata?: Record<string, unknown>;
+    approvalResponse?: {
+        approval_id: string;
+        approved: boolean;
+    };
+    onEvent?: ChatEventHandler;
+}
+export type CrossPlatformIngressMessage = ChatIngressMessage;
+export interface CrossPlatformChatSessionInfo {
+    session_key: string;
+    identity_key?: string;
+    platform?: string;
+    conversation_id?: string;
+    conversation_name?: string;
+    user_id?: string;
+    user_name?: string;
+    cwd: string;
+    created_at: string;
+    last_used_at: string;
+    last_message_id?: string;
+    chat_session_id?: string;
+    active_reply_target?: ChatIngressReplyTarget;
+    active_companion_contract?: CompanionRuntimeContract;
+    metadata: Record<string, unknown>;
+}
+//# sourceMappingURL=cross-platform-session-types.d.ts.map

package/dist/interface/chat/cross-platform-session-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-platform-session-types.d.ts","sourceRoot":"","sources":["../../../src/interface/chat/cross-platform-session-types.ts"],"names":[],"mappings":"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"}

package/dist/interface/chat/cross-platform-session-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cross-platform-session-types.js.map

package/dist/interface/chat/cross-platform-session-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-platform-session-types.js","sourceRoot":"","sources":["../../../src/interface/chat/cross-platform-session-types.ts"],"names":[],"mappings":""}