@stigmer/sdk 3.12.5 → 3.12.7

package/execution/transcript.js

@@ -0,0 +1,484 @@
+// The canonical, full-fidelity session transcript (stigmer/stigmer#814).
+//
+// A session's whole conversation — thinking included, tool calls with their
+// offloaded outputs resolved, sub-agent turns, timestamps — assembled ONCE
+// here so every consumer (the SessionViewer export control, the CLI, an
+// embedder's backend analysis job) reads the same authoritative record
+// instead of re-deriving it.
+//
+// Canonical rules, decided for #814:
+//   - Fidelity beats noise suppression. Thinking and system messages are
+//     carried verbatim; presentation-layer cleanups (the CLI replay's
+//     system-error rewriting, approval-noise dropping) stay in the
+//     presentation layers. The transcript is raw material for improving
+//     agents — the judgment signal lives in exactly the parts a polished
+//     view hides.
+//   - Tool calls attach to their parent MESSAGE_AI message. Every tool call
+//     lives on an AI message in the data model, so this shows each call
+//     exactly once, in position. (The CLI replay's started_at interleaving
+//     is an event-stream presentation need, not a data rule.)
+//   - Superseded turns (edit-and-resubmit) are excluded by default, matching
+//     what the conversation view shows; `includeSuperseded: true` keeps them,
+//     marked, for the history-faithful variant.
+//   - An in-flight execution exports as its last-persisted snapshot and is
+//     marked `inProgress` — honest about what a mid-run export is.
+//   - Sub-agent transcripts (`status.sub_agent_executions` — task-tool
+//     delegations) are embedded in the parent's status and export in full. A
+//     `call-agent` workflow task spawns a SEPARATE child AgentExecution in
+//     its own session; that is a different session's transcript, not part of
+//     this one.
+//
+// Like the rest of this folder, the module is framework-free: the fetch
+// entry point takes a structural client slice, so it runs in React hosts,
+// Node jobs, and the CLI alike.
+import { toJson } from "@bufbuild/protobuf";
+import { create } from "@bufbuild/protobuf";
+import { AgentExecutionSchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/api_pb";
+import { MessageType, ToolCallStatus, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { GetArtifactContentRequestSchema, ListAgentExecutionsBySessionRequestSchema, } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/io_pb";
+import { SessionSchema } from "@stigmer/protos/ai/stigmer/agentic/session/v1/api_pb";
+import { resolvedSubject } from "../session.js";
+import { execIdFromStorageKey, isBuildFromPlanTurn, sortChronologically, supersededExecutionIds, syntheticUserPrompt, } from "./conversation-rules.js";
+import { isTerminalPhase } from "./execution-phases.js";
+/**
+ * Assembles the canonical transcript from a session and its executions.
+ *
+ * Pure — same inputs, same transcript. Ordering, superseded filtering, and
+ * user-turn synthesis are the shared conversation rules from
+ * `conversation-rules.ts`, so this cannot drift from what the conversation
+ * view renders.
+ */
+export function assembleSessionTranscript(session, executions, options) {
+    const includeSuperseded = options?.includeSuperseded === true;
+    const ordered = sortChronologically(executions);
+    const superseded = supersededExecutionIds(ordered);
+    const turns = [];
+    for (const execution of ordered) {
+        const isSuperseded = superseded.has(execution.metadata?.id ?? "");
+        if (isSuperseded && !includeSuperseded)
+            continue;
+        const phase = execution.status?.phase;
+        turns.push({
+            execution,
+            userPrompt: syntheticUserPrompt(execution),
+            isBuildFromPlan: isBuildFromPlanTurn(execution),
+            superseded: isSuperseded,
+            inProgress: phase === undefined || !isTerminalPhase(phase),
+        });
+    }
+    return {
+        session,
+        turns,
+        resolvedOutputs: options?.resolvedOutputs ?? {},
+        includesSuperseded: includeSuperseded,
+    };
+}
+/**
+ * Fetches everything a session's transcript needs and assembles it.
+ *
+ * One `listBySession` call returns the complete execution set — both server
+ * editions answer this RPC unpaginated today (Go: `TODO: Implement
+ * pagination`; Java: "not using pagination with authorized IDs approach").
+ * If a future server starts paginating (`total_pages > 1`), this fails with
+ * a descriptive error rather than silently exporting a truncated
+ * "full-fidelity" transcript.
+ */
+export async function fetchSessionTranscript(client, sessionId, options) {
+    const [session, list] = await Promise.all([
+        client.session.get(sessionId),
+        client.agentExecution.listBySession(create(ListAgentExecutionsBySessionRequestSchema, { sessionId })),
+    ]);
+    if (list.totalPages > 1) {
+        throw new Error(`Session ${sessionId} has ${list.totalPages} pages of executions but ` +
+            "transcript export reads a single page. The server has started " +
+            "paginating listBySession; teach fetchSessionTranscript to walk " +
+            "pages before exporting, so no turns are silently dropped.");
+    }
+    const resolvedOutputs = options?.resolveOutputs === false
+        ? {}
+        : await resolveOffloadedOutputs(client, list.entries, {
+            concurrency: options?.concurrency,
+        });
+    return assembleSessionTranscript(session, list.entries, {
+        includeSuperseded: options?.includeSuperseded,
+        resolvedOutputs,
+    });
+}
+/**
+ * Fetches the content behind every offloaded tool output in the given
+ * executions (parent and sub-agent transcripts alike), keyed by storage key.
+ *
+ * Image refs are never fetched — serializers render them as notes. The
+ * execution id for each fetch derives from the storage key itself
+ * (`execIdFromStorageKey`): sub-agent outputs are stored under the PARENT
+ * execution's id, and the key is the record of that.
+ */
+export async function resolveOffloadedOutputs(client, executions, options) {
+    const refs = new Map();
+    for (const execution of executions) {
+        for (const toolCall of allToolCalls(execution.status)) {
+            const ref = toolCall.outputRef;
+            if (ref?.storageKey)
+                refs.set(ref.storageKey, ref);
+        }
+    }
+    const resolved = {};
+    const decoder = new TextDecoder("utf-8", { fatal: false });
+    await mapWithConcurrency([...refs.values()], options?.concurrency ?? 4, async (ref) => {
+        const base = {
+            storageKey: ref.storageKey,
+            mimeType: ref.mimeType,
+            isImage: ref.isImage,
+            totalSizeBytes: Number(ref.sizeBytes),
+        };
+        if (ref.isImage) {
+            resolved[ref.storageKey] = { ...base, truncated: false };
+            return;
+        }
+        const executionId = execIdFromStorageKey(ref.storageKey);
+        if (!executionId) {
+            resolved[ref.storageKey] = {
+                ...base,
+                truncated: false,
+                error: `unexpected storage key shape: ${ref.storageKey}`,
+            };
+            return;
+        }
+        try {
+            const response = await client.agentExecution.getArtifactContent(create(GetArtifactContentRequestSchema, {
+                executionId,
+                storageKey: ref.storageKey,
+            }));
+            resolved[ref.storageKey] = {
+                ...base,
+                content: decoder.decode(response.content),
+                truncated: response.truncated,
+                totalSizeBytes: Number(response.totalSizeBytes),
+            };
+        }
+        catch (e) {
+            resolved[ref.storageKey] = {
+                ...base,
+                truncated: false,
+                error: e instanceof Error ? e.message : String(e),
+            };
+        }
+    });
+    return resolved;
+}
+/** Every tool call in an execution's status — the parent transcript's plus
+ * each embedded sub-agent transcript's. */
+function* allToolCalls(status) {
+    if (!status)
+        return;
+    const messageLists = [
+        status.messages,
+        ...status.subAgentExecutions.map((sa) => sa.messages),
+    ];
+    for (const messages of messageLists) {
+        for (const message of messages) {
+            yield* message.toolCalls;
+        }
+    }
+}
+/** Runs `fn` over `items` with at most `limit` in flight. */
+async function mapWithConcurrency(items, limit, fn) {
+    let next = 0;
+    const workers = Array.from({ length: Math.max(1, Math.min(limit, items.length)) }, async () => {
+        while (next < items.length) {
+            const item = items[next++];
+            await fn(item);
+        }
+    });
+    await Promise.all(workers);
+}
+/**
+ * Renders the transcript as a self-contained Markdown document.
+ *
+ * Deterministic: same transcript, same bytes — the format is a pinned
+ * contract (see `__tests__/transcript.test.ts`). Roles are bold labels
+ * (User / Assistant / Thinking / System), thinking and system content is
+ * blockquoted, tool calls carry fenced args and output, and sub-agent turns
+ * are blockquoted sections. Fences self-size past any backtick runs in the
+ * content, so hostile content cannot break out of its block.
+ */
+export function transcriptToMarkdown(transcript, options) {
+    const { session, turns, resolvedOutputs } = transcript;
+    const out = [];
+    const sessionId = session.metadata?.id ?? "";
+    const title = resolvedSubject(session.spec?.subject) ?? `Session ${sessionId}`;
+    out.push(`# ${title}`, "");
+    out.push(`- Session: \`${sessionId}\``);
+    const agentInstanceId = session.spec?.agentInstanceId;
+    if (agentInstanceId)
+        out.push(`- Agent instance: \`${agentInstanceId}\``);
+    out.push(`- Turns: ${turns.length}`);
+    if (transcript.includesSuperseded) {
+        out.push("- Includes superseded (edited-and-resubmitted) turns");
+    }
+    if (options?.generatedAt)
+        out.push(`- Exported: ${options.generatedAt}`);
+    for (let i = 0; i < turns.length; i++) {
+        const turn = turns[i];
+        out.push("", "---", "");
+        out.push(`## Turn ${i + 1}${turnHeaderSuffix(turn)}`);
+        if (turn.superseded) {
+            out.push("", "_Superseded by an edited resubmission._");
+        }
+        if (turn.inProgress) {
+            out.push("", "_In progress at export time — content is the last persisted snapshot._");
+        }
+        if (turn.isBuildFromPlan) {
+            out.push("", "_Build from plan._");
+        }
+        if (turn.userPrompt !== null) {
+            out.push("", "**User**", "", turn.userPrompt);
+        }
+        renderMessages(out, turn.execution.status?.messages ?? [], turn.execution.status?.subAgentExecutions ?? [], resolvedOutputs, turn.userPrompt);
+        const error = turn.execution.status?.error;
+        if (error) {
+            out.push("", "**Execution error**", "", blockquote(error));
+        }
+    }
+    out.push("");
+    return out.join("\n");
+}
+function turnHeaderSuffix(turn) {
+    const startedAt = turn.execution.status?.startedAt;
+    return startedAt ? ` · ${startedAt}` : "";
+}
+/** Renders one message list — the parent turn's or a sub-agent's. */
+function renderMessages(out, messages, subAgents, resolvedOutputs, userPrompt) {
+    for (const message of messages) {
+        switch (message.type) {
+            case MessageType.MESSAGE_TOOL:
+                // Tool calls render from their parent MESSAGE_AI's tool_calls (the
+                // canonical attach rule); the MESSAGE_TOOL echo would double them.
+                continue;
+            case MessageType.MESSAGE_HUMAN: {
+                // The turn's opening prompt is already rendered from spec.message;
+                // skip its status.messages echo. Any OTHER human message is kept.
+                if (userPrompt !== null && message.content === userPrompt)
+                    continue;
+                out.push("", "**User**", "", message.content);
+                continue;
+            }
+            case MessageType.MESSAGE_THINKING:
+                out.push("", "**Thinking**", "", blockquote(message.content));
+                continue;
+            case MessageType.MESSAGE_SYSTEM:
+                out.push("", "**System**", "", blockquote(message.content));
+                continue;
+            case MessageType.MESSAGE_AI: {
+                if (message.content.trim()) {
+                    out.push("", "**Assistant**", "", message.content);
+                }
+                for (const toolCall of message.toolCalls) {
+                    if (toolCall.name === "task") {
+                        const subAgent = subAgents.find((sa) => sa.id === toolCall.id);
+                        if (subAgent) {
+                            renderSubAgent(out, subAgent, resolvedOutputs);
+                            continue;
+                        }
+                    }
+                    renderToolCall(out, toolCall, resolvedOutputs);
+                }
+                continue;
+            }
+            default:
+                // Unknown future message type: carry the content rather than drop it.
+                if (message.content)
+                    out.push("", blockquote(message.content));
+        }
+    }
+}
+function renderToolCall(out, toolCall, resolvedOutputs) {
+    out.push("", `**Tool — \`${toolCall.name}\`**${toolCallSuffix(toolCall)}`);
+    // ToolCall.args is a google.protobuf.Struct, which protobuf-es represents
+    // as a plain JsonObject — safe to stringify directly (no bigint fields).
+    const args = toolCall.args
+        ? JSON.stringify(toolCall.args, null, 2)
+        : undefined;
+    if (args && args !== "{}") {
+        out.push("", fenced(args, "json"));
+    }
+    const output = toolOutputText(toolCall, resolvedOutputs);
+    if (output.note)
+        out.push("", `_${output.note}_`);
+    if (output.text)
+        out.push("", fenced(output.text));
+    if (toolCall.error) {
+        out.push("", "Error:", "", fenced(toolCall.error));
+    }
+}
+/** The output text and honesty note for a tool call, applying the
+ * offload-resolution fallbacks. */
+function toolOutputText(toolCall, resolvedOutputs) {
+    const ref = toolCall.outputRef;
+    if (!ref?.storageKey) {
+        return toolCall.result ? { text: toolCall.result } : {};
+    }
+    if (ref.isImage) {
+        return {
+            note: `Image output (${ref.mimeType || "image"}, ${Number(ref.sizeBytes)} bytes) — not inlined.`,
+        };
+    }
+    const resolved = resolvedOutputs[ref.storageKey];
+    if (resolved?.content !== undefined) {
+        return {
+            text: resolved.content,
+            note: resolved.truncated
+                ? `Output truncated at ${resolved.content.length} of ${resolved.totalSizeBytes} bytes (server content cap).`
+                : undefined,
+        };
+    }
+    return {
+        text: ref.truncatedPreview || toolCall.result || undefined,
+        note: resolved?.error
+            ? `Offloaded output unavailable (${resolved.error}) — showing preview.`
+            : "Offloaded output not resolved — showing preview.",
+    };
+}
+function toolCallSuffix(toolCall) {
+    const parts = [];
+    const status = toolCallStatusLabel(toolCall.status);
+    if (status)
+        parts.push(status);
+    const duration = formatDuration(toolCall.startedAt, toolCall.completedAt);
+    if (duration)
+        parts.push(duration);
+    return parts.length > 0 ? ` (${parts.join(" · ")})` : "";
+}
+function toolCallStatusLabel(status) {
+    switch (status) {
+        case ToolCallStatus.TOOL_CALL_COMPLETED:
+            return "completed";
+        case ToolCallStatus.TOOL_CALL_FAILED:
+            return "failed";
+        case ToolCallStatus.TOOL_CALL_SKIPPED:
+            return "skipped";
+        case ToolCallStatus.TOOL_CALL_INTERRUPTED:
+            return "interrupted";
+        case ToolCallStatus.TOOL_CALL_RUNNING:
+            return "running";
+        case ToolCallStatus.TOOL_CALL_WAITING_APPROVAL:
+            return "waiting for approval";
+        case ToolCallStatus.TOOL_CALL_PENDING:
+            return "pending";
+        default:
+            return null;
+    }
+}
+function renderSubAgent(out, subAgent, resolvedOutputs) {
+    const nested = [];
+    const title = subAgent.subject || subAgent.name || "sub-agent";
+    nested.push(`**Sub-agent — ${title}**${subAgentSuffix(subAgent)}`);
+    if (subAgent.input) {
+        nested.push("", "Input:", "", subAgent.input);
+    }
+    renderMessages(nested, subAgent.messages, [], resolvedOutputs, null);
+    if (subAgent.output) {
+        nested.push("", "Output:", "", subAgent.output);
+    }
+    if (subAgent.error) {
+        nested.push("", "Error:", "", fenced(subAgent.error));
+    }
+    out.push("", blockquote(nested.join("\n")));
+}
+function subAgentSuffix(subAgent) {
+    const duration = formatDuration(subAgent.startedAt, subAgent.completedAt);
+    return duration ? ` (${duration})` : "";
+}
+/** `"3.2s"` when both ISO timestamps parse and are ordered, else `null`. */
+function formatDuration(startedAt, completedAt) {
+    if (!startedAt || !completedAt)
+        return null;
+    const start = Date.parse(startedAt);
+    const end = Date.parse(completedAt);
+    if (Number.isNaN(start) || Number.isNaN(end) || end < start)
+        return null;
+    const ms = end - start;
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+/** Prefixes every line with `> ` (blockquote), including blank lines. */
+function blockquote(text) {
+    return text
+        .split("\n")
+        .map((line) => (line.length > 0 ? `> ${line}` : ">"))
+        .join("\n");
+}
+/**
+ * Wraps content in a code fence sized past its longest backtick run, so
+ * content containing ``` can never terminate the block early.
+ */
+function fenced(content, language = "") {
+    let longest = 0;
+    for (const match of content.matchAll(/`+/g)) {
+        if (match[0].length > longest)
+            longest = match[0].length;
+    }
+    const fence = "`".repeat(Math.max(3, longest + 1));
+    return `${fence}${language}\n${content}\n${fence}`;
+}
+// ============================================================================
+// JSON serialization
+// ============================================================================
+/**
+ * Renders the transcript as a plain JSON value for programmatic analysis.
+ *
+ * Proto parts serialize through `toJson` with `useProtoFieldName: true` —
+ * the platform-wide protojson parity contract (snake_case fields, int64 as
+ * strings, `fromJson` round-trippable). Never `JSON.stringify` a raw proto
+ * object here: int64 fields are `bigint` and would throw.
+ *
+ * One deliberate omission: `status.callback_token` is stripped. It is an
+ * internal Temporal task token (runtime plumbing for workflow-triggered
+ * executions), not conversation material, and has no place in a document
+ * users share and paste around.
+ */
+export function transcriptToJson(transcript) {
+    const turns = transcript.turns.map((turn) => {
+        const execution = toJson(AgentExecutionSchema, turn.execution, {
+            useProtoFieldName: true,
+        });
+        if (execution !== null &&
+            typeof execution === "object" &&
+            !Array.isArray(execution)) {
+            const status = execution["status"];
+            if (status !== null && typeof status === "object" && !Array.isArray(status)) {
+                delete status["callback_token"];
+            }
+        }
+        return {
+            user_prompt: turn.userPrompt,
+            build_from_plan: turn.isBuildFromPlan || undefined,
+            superseded: turn.superseded || undefined,
+            in_progress: turn.inProgress || undefined,
+            execution,
+        };
+    });
+    const resolvedOutputs = {};
+    for (const [key, output] of Object.entries(transcript.resolvedOutputs)) {
+        resolvedOutputs[key] = {
+            storage_key: output.storageKey,
+            content: output.content,
+            truncated: output.truncated || undefined,
+            total_size_bytes: output.totalSizeBytes,
+            mime_type: output.mimeType,
+            is_image: output.isImage || undefined,
+            error: output.error,
+        };
+    }
+    return {
+        format: "stigmer.ai/session-transcript/v1",
+        session: toJson(SessionSchema, transcript.session, {
+            useProtoFieldName: true,
+        }),
+        includes_superseded: transcript.includesSuperseded,
+        turns,
+        resolved_outputs: resolvedOutputs,
+    };
+}
+//# sourceMappingURL=transcript.js.map

package/execution/transcript.js.map

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

package/gen/agent.d.ts

@@ -22,6 +22,14 @@ export declare class AgentClient {
 }
 /** Input for creating/updating a Agent. */
 export interface AgentInput {
+    /**
+     * The resource's `metadata.id`, for exact update addressing when set
+     * from a loaded resource. Required for updates to platform-scoped
+     * (org-less) kinds, where the org+slug fallback cannot match. On
+     * create, the cloud server stamps its own id regardless; the OSS
+     * server honors a caller-supplied id (existing apply semantics).
+     */
+    id?: string;
     name: string;
     slug?: string;
     org: string;
@@ -68,4 +76,17 @@ export interface EnvVarDeclarationInput {
     optional?: boolean;
 }
 export declare function buildAgentProto(input: AgentInput): Agent;
+/**
+ * Maps a fetched {@link Agent} to a complete {@link AgentInput} for `update()`.
+ *
+ * The update RPC replaces the ENTIRE spec — spread this mapper's output
+ * and override only the fields you edit (spread nested objects the same
+ * way):
+ *
+ *   await client.update({ ...toAgentUpdateInput(res), description: next });
+ *
+ * Proto3 defaults normalize to `undefined`; resource references keep
+ * `version` (pinned refs) and `kind`.
+ */
+export declare function toAgentUpdateInput(resource: Agent): AgentInput;
 //# sourceMappingURL=agent.d.ts.map

package/gen/agent.d.ts.map

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

package/gen/agent.js

@@ -1,6 +1,6 @@
 // Code generated by stigmer-codegen. DO NOT EDIT.
 import { wrapError } from "./errors.js";
-import { stripUndefined } from "./proto-utils.js";
+import { stripUndefined, toResourceRefInput, toResourceRefInputs } from "./proto-utils.js";
 import { create } from "@bufbuild/protobuf";
 import { createClient } from "@connectrpc/connect";
 import { AgentSchema } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/api_pb";
@@ -168,6 +168,7 @@ export function buildAgentProto(input) {
         apiVersion: "agentic.stigmer.ai/v1",
         kind: "Agent",
         metadata: Object.assign(create(ApiResourceMetadataSchema), {
+            ...(input.id && { id: input.id }),
             name: input.name,
             org: input.org,
             ...(input.slug && { slug: input.slug }),
@@ -185,4 +186,75 @@ export function buildAgentProto(input) {
         })),
     });
 }
+function toToolApprovalOverrideInput(msg) {
+    return {
+        toolName: msg.toolName || undefined,
+        requiresApproval: msg.requiresApproval || undefined,
+        message: msg.message || undefined,
+    };
+}
+function toMcpServerUsageInput(msg) {
+    return {
+        mcpServerRef: toResourceRefInput(msg.mcpServerRef) ?? { org: "", slug: "" },
+        enabledTools: msg.enabledTools?.length ? [...msg.enabledTools] : undefined,
+        toolApprovalOverrides: msg.toolApprovalOverrides?.length ? msg.toolApprovalOverrides.map(toToolApprovalOverrideInput) : undefined,
+    };
+}
+function toMcpAccessInput(msg) {
+    return {
+        mcpServer: msg.mcpServer ?? "",
+        enabledTools: msg.enabledTools?.length ? [...msg.enabledTools] : undefined,
+    };
+}
+function toSubAgentInput(msg) {
+    return {
+        name: msg.name ?? "",
+        description: msg.description || undefined,
+        instructions: msg.instructions || undefined,
+        mcpAccess: msg.mcpAccess?.length ? msg.mcpAccess.map(toMcpAccessInput) : undefined,
+        skillRefs: toResourceRefInputs(msg.skillRefs),
+        modelOverride: msg.modelOverride || undefined,
+    };
+}
+function toEnvVarDeclarationInput(msg) {
+    return {
+        isSecret: msg.isSecret || undefined,
+        description: msg.description || undefined,
+        optional: msg.optional || undefined,
+    };
+}
+/**
+ * Maps a fetched {@link Agent} to a complete {@link AgentInput} for `update()`.
+ *
+ * The update RPC replaces the ENTIRE spec — spread this mapper's output
+ * and override only the fields you edit (spread nested objects the same
+ * way):
+ *
+ *   await client.update({ ...toAgentUpdateInput(res), description: next });
+ *
+ * Proto3 defaults normalize to `undefined`; resource references keep
+ * `version` (pinned refs) and `kind`.
+ */
+export function toAgentUpdateInput(resource) {
+    const meta = resource.metadata;
+    const spec = resource.spec ?? create(AgentSpecSchema);
+    return {
+        // Exact update addressing (id-first in the update pipeline) — for
+        // platform-scoped (org-less) kinds the org+slug fallback cannot
+        // match, so the id is the ONLY working address.
+        id: meta?.id || undefined,
+        name: meta?.name ?? "",
+        slug: meta?.slug || undefined,
+        org: meta?.org ?? "",
+        labels: meta?.labels && Object.keys(meta.labels).length > 0 ? { ...meta.labels } : undefined,
+        visibility: meta?.visibility || undefined,
+        description: spec.description || undefined,
+        iconUrl: spec.iconUrl || undefined,
+        instructions: spec.instructions || undefined,
+        mcpServerUsages: spec.mcpServerUsages?.length ? spec.mcpServerUsages.map(toMcpServerUsageInput) : undefined,
+        skillRefs: toResourceRefInputs(spec.skillRefs),
+        subAgents: spec.subAgents?.length ? spec.subAgents.map(toSubAgentInput) : undefined,
+        env: Object.keys(spec.env ?? {}).length > 0 ? Object.fromEntries(Object.entries(spec.env).map(([k, v]) => [k, toEnvVarDeclarationInput(v)])) : undefined,
+    };
+}
 //# sourceMappingURL=agent.js.map