pilotswarm-sdk 0.3.1 → 0.3.2

package/dist/session-proxy.d.ts

@@ -5,6 +5,16 @@ import type { StorageConfig } from "./storage-config.js";
 import { type SerializableSessionConfig } from "./types.js";
 import type { AgentConfig } from "./agent-loader.js";
 import { type CronAtSchedule } from "./cron-at.js";
+export declare function prepareStickySessionTitleUpdate(catalog: Pick<SessionCatalog, "getSession">, sessionId: string, requestedTitle: unknown): Promise<{
+    ok: true;
+    updates: {
+        title: string;
+        titleLocked: true;
+    };
+} | {
+    ok: false;
+    message: string;
+}>;
 export declare function createSessionProxy(ctx: any, sessionId: string, affinityKey: string, config: SerializableSessionConfig): {
     runTurn(prompt: string, bootstrap?: boolean, turnIndex?: number, turnMeta?: {
         parentSessionId?: string;
@@ -93,6 +103,8 @@ export declare function createSessionManagerProxy(ctx: any): {
     deleteSession(sessionId: string, reason?: string): any;
     /** Update a session's CMS state (e.g. "rejected" for policy violations). */
     updateCmsState(sessionId: string, state: string, lastError?: string | null, waitReason?: string | null): any;
+    /** Persist this session's model metadata in CMS. */
+    updateSessionModel(sessionId: string, model: string, reasoningEffort?: string | null): any;
     /** Get the worker's authoritative session policy + allowed agent names. */
     getWorkerSessionPolicy(): any;
     /** Load curated skills and open asks from the knowledge pipeline. */

package/dist/session-proxy.d.ts.map

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

package/dist/session-proxy.js

@@ -29,6 +29,7 @@ function normalizeJsonObject(value) {
     return value;
 }
 const SUMMARY_STATE_TEMPLATE = '{"schemaVersion":1,"updatedAt":"2026-05-18T00:00:00.000Z","intent":"...","summary":"...","state":{},"openQuestions":[],"blockers":[],"nextActions":[],"links":[],"structureChangeLog":[]}';
+const MAX_SESSION_TITLE_LENGTH = 60;
 function normalizeSummaryArray(value) {
     if (Array.isArray(value))
         return value;
@@ -74,6 +75,42 @@ function normalizeSummaryState(value) {
         },
     };
 }
+function normalizeSessionTitleInput(title, maxLength = MAX_SESSION_TITLE_LENGTH) {
+    return String(title || "").trim().slice(0, maxLength);
+}
+function getNamedAgentTitlePrefix(session) {
+    if (!session?.agentId)
+        return null;
+    const currentTitle = String(session.title || "").trim();
+    if (!currentTitle)
+        return null;
+    const separatorIndex = currentTitle.indexOf(": ");
+    if (separatorIndex > 0)
+        return currentTitle.slice(0, separatorIndex).trim() || null;
+    return currentTitle || null;
+}
+function buildStickySessionTitle(session, requestedTitle) {
+    const normalizedTitle = normalizeSessionTitleInput(requestedTitle);
+    const prefix = getNamedAgentTitlePrefix(session);
+    if (!prefix)
+        return normalizedTitle;
+    const prefixLabel = `${prefix}: `;
+    const maxSuffixLength = Math.max(0, MAX_SESSION_TITLE_LENGTH - prefixLabel.length);
+    if (maxSuffixLength <= 0)
+        return prefix.slice(0, MAX_SESSION_TITLE_LENGTH);
+    return `${prefixLabel}${normalizedTitle.slice(0, maxSuffixLength)}`;
+}
+export async function prepareStickySessionTitleUpdate(catalog, sessionId, requestedTitle) {
+    const session = await catalog.getSession(sessionId);
+    if (!session)
+        return { ok: false, message: `Session ${sessionId.slice(0, 8)} was not found.` };
+    if (session.isSystem)
+        return { ok: false, message: "System session titles are fixed" };
+    const title = buildStickySessionTitle(session, requestedTitle);
+    if (!title)
+        return { ok: false, message: "Title cannot be empty" };
+    return { ok: true, updates: { title, titleLocked: true } };
+}
 function buildContractJson(contract, parentSessionId, childSessionId) {
     const normalized = normalizeJsonObject(contract);
     if (!normalized)
@@ -543,6 +580,10 @@ export function createSessionManagerProxy(ctx) {
                 payload.waitReason = waitReason;
             return ctx.scheduleActivity("updateCmsState", payload);
         },
+        /** Persist this session's model metadata in CMS. */
+        updateSessionModel(sessionId, model, reasoningEffort) {
+            return ctx.scheduleActivity("updateSessionModel", { sessionId, model, reasoningEffort });
+        },
         /** Get the worker's authoritative session policy + allowed agent names. */
         getWorkerSessionPolicy() {
             return ctx.scheduleActivity("getWorkerSessionPolicy", {});
@@ -608,6 +649,7 @@ workerNodeId) {
             toolNames: new Set(),
             modelSummary: sessionManager.getModelSummary(),
         };
+        const turnStartedAt = new Date();
         const turnSpan = otelTrace.getTracer("pilotswarm-turns").startSpan("session.turn", {
             attributes: {
                 "pilotswarm.session_id": input.sessionId,
@@ -992,6 +1034,38 @@ workerNodeId) {
                             return `[SYSTEM: spawn_agent failed: ${err?.message || String(err)}]`;
                         }
                     },
+                    setSessionModel: async (args) => {
+                        try {
+                            const requestedModel = String(args.model || "").trim();
+                            if (!requestedModel)
+                                return "[SYSTEM: set_session_model failed: model is required.]";
+                            if (!storeUrl)
+                                return "[SYSTEM: set_session_model failed: no storeUrl is configured.]";
+                            const resolved = sessionManager.resolveModelSwitchConfig(requestedModel, "reasoning_effort" in args ? args.reasoning_effort ?? null : undefined);
+                            const sdkClient = new PilotSwarmClient(internalClientConfig());
+                            try {
+                                await sdkClient.start();
+                                await sdkClient.duroxideClient.enqueueEvent(`session-${input.sessionId}`, "messages", JSON.stringify({
+                                    type: "cmd",
+                                    cmd: "set_model",
+                                    id: `set-model-tool-${randomUUID()}`,
+                                    args: {
+                                        model: resolved.model,
+                                        reasoningEffort: resolved.reasoningEffort,
+                                        source: "tool",
+                                    },
+                                }));
+                            }
+                            finally {
+                                await sdkClient.stop().catch(() => { });
+                            }
+                            const effortText = resolved.reasoningEffort ? `:${resolved.reasoningEffort}` : "";
+                            return `[SYSTEM: Model switch accepted. Stop this turn now; the runtime will automatically continue on ${resolved.model}${effortText}.]`;
+                        }
+                        catch (err) {
+                            return `[SYSTEM: set_session_model failed: ${err?.message || String(err)}]`;
+                        }
+                    },
                     messageAgent: async (args) => {
                         try {
                             const child = await resolveManagedChild(args.agent_id);
@@ -1128,11 +1202,33 @@ workerNodeId) {
                                 return `[SYSTEM: update_session_summary is disabled for read-only agent-tuner sessions.]`;
                             if (!catalog)
                                 return `[SYSTEM: update_session_summary failed: CMS catalog is unavailable.]`;
-                            const normalizedSummary = normalizeSummaryState(args.summary_state);
-                            if (!normalizedSummary.ok)
-                                return `[SYSTEM: update_session_summary failed: ${normalizedSummary.message}]`;
-                            await catalog.updateSessionSummary(input.sessionId, normalizedSummary.summaryState, args.short_summary);
-                            return `[SYSTEM: Session summary updated.]`;
+                            const hasSummaryState = Object.prototype.hasOwnProperty.call(args ?? {}, "summary_state") && args.summary_state !== undefined && args.summary_state !== null;
+                            const hasTitle = Object.prototype.hasOwnProperty.call(args ?? {}, "title");
+                            if (!hasSummaryState && !hasTitle) {
+                                return `[SYSTEM: update_session_summary failed: summary_state or title is required.]`;
+                            }
+                            let normalizedSummary;
+                            if (hasSummaryState) {
+                                const summaryResult = normalizeSummaryState(args.summary_state);
+                                if (!summaryResult.ok)
+                                    return `[SYSTEM: update_session_summary failed: ${summaryResult.message}]`;
+                                normalizedSummary = summaryResult;
+                            }
+                            const titleUpdate = hasTitle
+                                ? await prepareStickySessionTitleUpdate(catalog, input.sessionId, args.title)
+                                : undefined;
+                            if (titleUpdate && !titleUpdate.ok)
+                                return `[SYSTEM: update_session_summary failed: ${titleUpdate.message}]`;
+                            const updated = [];
+                            if (normalizedSummary) {
+                                await catalog.updateSessionSummary(input.sessionId, normalizedSummary.summaryState, args.short_summary);
+                                updated.push("summary");
+                            }
+                            if (titleUpdate?.ok) {
+                                await catalog.updateSession(input.sessionId, titleUpdate.updates);
+                                updated.push("title");
+                            }
+                            return `[SYSTEM: Session ${updated.join(" and ")} updated.]`;
                         }
                         catch (err) {
                             return `[SYSTEM: update_session_summary failed: ${err?.message || String(err)}]`;
@@ -1343,7 +1439,6 @@ workerNodeId) {
                                 turnTelemetry.tokensOutput += usageUpsert.tokensOutputIncrement ?? 0;
                                 turnTelemetry.tokensCacheRead += usageUpsert.tokensCacheReadIncrement ?? 0;
                                 turnTelemetry.tokensCacheWrite += usageUpsert.tokensCacheWriteIncrement ?? 0;
-                                void cmsRetryBestEffort(`runTurn.onEvent upsertSummary usage session=${input.sessionId}`, () => catalog.upsertSessionMetricSummary(input.sessionId, usageUpsert), (msg) => activityCtx.traceInfo(msg));
                             }
                         }
                         else if (event.eventType === "tool.execution_start") {
@@ -1514,7 +1609,8 @@ workerNodeId) {
                     };
                 }
                 activityCtx.traceInfo(`[runTurn] ManagedSession.runTurn completed for ${input.sessionId} type=${result.type}`);
-                // Record turn_completed CMS event.
+                // Drain event writes before the atomic post-turn writeback records
+                // session.turn_completed.
                 //
                 // Ordering matters here: every per-event CMS write fired by the
                 // SDK's onEvent callback (assistant.message, tool calls, usage,
@@ -1543,10 +1639,6 @@ workerNodeId) {
                     if (pendingWritesAtBarrier.length > 0) {
                         await Promise.allSettled(pendingWritesAtBarrier);
                     }
-                    await cmsRetryBestEffort(`runTurn.recordEvent turn_completed session=${input.sessionId}`, () => catalog.recordEvents(input.sessionId, [{
-                            eventType: "session.turn_completed",
-                            data: { iteration: input.turnIndex ?? 0 },
-                        }], workerNodeId), (msg) => activityCtx.traceInfo(msg));
                 }
                 if (cancelled)
                     return { type: "cancelled" };
@@ -1591,8 +1683,32 @@ workerNodeId) {
                         updates.waitReason = null;
                         updates.lastError = null;
                     }
-                    const capturedUpdates = updates;
-                    await cmsRetryBestEffort(`runTurn.postTurn updateSession state=${capturedUpdates.state} session=${input.sessionId}`, () => catalog.updateSession(input.sessionId, capturedUpdates), (msg) => activityCtx.traceInfo(msg));
+                    const turnEndedAt = new Date();
+                    await cmsRetryBestEffort(`runTurn.postTurn completeTurnWriteback state=${updates.state} session=${input.sessionId}`, () => catalog.completeTurnWriteback({
+                        sessionId: input.sessionId,
+                        agentId: null,
+                        model: input.config.model ?? null,
+                        reasoningEffort: input.config.reasoningEffort ?? null,
+                        turnIndex: input.turnIndex ?? 0,
+                        startedAt: turnStartedAt,
+                        endedAt: turnEndedAt,
+                        durationMs: Math.max(0, turnEndedAt.getTime() - turnStartedAt.getTime()),
+                        tokensInput: turnTelemetry.tokensInput,
+                        tokensOutput: turnTelemetry.tokensOutput,
+                        tokensCacheRead: turnTelemetry.tokensCacheRead,
+                        tokensCacheWrite: turnTelemetry.tokensCacheWrite,
+                        toolCalls: turnTelemetry.toolCalls,
+                        toolErrors: turnTelemetry.toolErrors,
+                        toolNames: Array.from(turnTelemetry.toolNames).sort(),
+                        resultType: result.type,
+                        errorMessage: result.type === "error" ? (result.message ?? null) : null,
+                        workerNodeId: workerNodeId ?? null,
+                        state: updates.state ?? "idle",
+                        lastActiveAt: updates.lastActiveAt ?? turnEndedAt,
+                        lastError: updates.lastError ?? null,
+                        waitReason: updates.waitReason ?? null,
+                        currentIteration: input.turnIndex ?? 0,
+                    }), (msg) => activityCtx.traceInfo(msg));
                 }
                 return result;
             }, { trace });
@@ -2110,6 +2226,7 @@ workerNodeId) {
                 parentSessionId: input.parentSessionId,
                 nestingLevel: input.nestingLevel,
                 model: input.config.model,
+                reasoningEffort: input.config.reasoningEffort,
                 systemMessage: input.config.systemMessage,
                 boundAgentName: input.config.boundAgentName,
                 promptLayering: input.config.promptLayering,
@@ -2399,6 +2516,13 @@ workerNodeId) {
                 updates.waitReason = input.waitReason ?? null;
             await cmsRetryCritical(`updateCmsState session=${input.sessionId} state=${input.state}`, () => catalog.updateSession(input.sessionId, { ...updates }), (msg) => activityCtx.traceInfo(msg));
         });
+        runtime.registerActivity("updateSessionModel", async (activityCtx, input) => {
+            activityCtx.traceInfo(`[updateSessionModel] session=${input.sessionId} model=${input.model}`);
+            await cmsRetryCritical(`updateSessionModel session=${input.sessionId}`, () => catalog.updateSession(input.sessionId, {
+                model: input.model,
+                reasoningEffort: input.reasoningEffort ?? null,
+            }), (msg) => activityCtx.traceInfo(msg));
+        });
     }
     // ── getWorkerSessionPolicy ──────────────────────────────
     // Returns the worker's session policy and allowed agent names.