@sema-agent/server 1.185.0

package/dist/session-sync.js

@@ -0,0 +1,181 @@
+import { validateEntriesForImport } from "@sema-agent/core";
+export function stagingIdFor(realSessionId, token) {
+    return `${realSessionId}#stg-${token}`;
+}
+export const STAGING_ID_MARKER = "#stg-";
+export function realIdOfStaging(stagingId) {
+    const i = stagingId.indexOf(STAGING_ID_MARKER);
+    return i < 0 ? null : stagingId.slice(0, i);
+}
+export function classifySyncRelationship(srcEntries, dstEntries) {
+    return classifySyncRelationshipByIds(srcEntries.map((e) => e.id), dstEntries === null ? null : dstEntries.map((e) => e.id));
+}
+export function classifySyncRelationshipByIds(srcIds, dstIds) {
+    if (dstIds === null || dstIds.length === 0)
+        return { relation: "fresh" };
+    const srcSet = new Set(srcIds);
+    const dstSet = new Set(dstIds);
+    if (srcSet.size === dstSet.size && [...srcSet].every((id) => dstSet.has(id)))
+        return { relation: "identical" };
+    const allDstInSrc = [...dstSet].every((id) => srcSet.has(id));
+    const allSrcInDst = [...srcSet].every((id) => dstSet.has(id));
+    if (allDstInSrc && !allSrcInDst) {
+        const newEntryIds = srcIds.filter((id) => !dstSet.has(id));
+        return { relation: "fast_forward", newEntryIds };
+    }
+    if (allSrcInDst && !allDstInSrc) {
+        const dstAheadBy = dstIds.filter((id) => !srcSet.has(id));
+        return { relation: "stale", dstAheadBy };
+    }
+    const srcExclusive = srcIds.filter((id) => !dstSet.has(id));
+    const dstExclusive = dstIds.filter((id) => !srcSet.has(id));
+    let commonAncestor = null;
+    for (const id of srcIds)
+        if (dstSet.has(id))
+            commonAncestor = id;
+    return { relation: "fork", commonAncestor, srcExclusive, dstExclusive };
+}
+export class SyncConflictError extends Error {
+    sessionId;
+    relation;
+    constructor(sessionId, relation) {
+        super(`session-sync: refusing to import session ${sessionId} — ${relation.relation} (would lose destination history; resolve explicitly)`);
+        this.sessionId = sessionId;
+        this.relation = relation;
+        this.name = "SyncConflictError";
+    }
+}
+function ownerAware(backend) {
+    return backend.session();
+}
+export async function exportSession(sessionId, srcBackend) {
+    const session = ownerAware(srcBackend);
+    const exportEntries = session.exportEntries?.bind(session);
+    if (!exportEntries) {
+        return null;
+    }
+    const entries = await exportEntries(sessionId);
+    if (entries === null)
+        return null;
+    const fs = srcBackend.fileSnapshot();
+    const snapshots = [];
+    if (typeof fs.listKeys === "function" && typeof fs.exportManifest === "function") {
+        const keys = await fs.listKeys(sessionId);
+        for (const key of keys) {
+            const manifest = await fs.exportManifest(sessionId, key);
+            if (manifest === null)
+                continue;
+            snapshots.push({ key, manifest: [...manifest] });
+        }
+    }
+    const policyStore = srcBackend.sessionPolicy();
+    const policy = typeof policyStore.listBySession === "function"
+        ? await policyStore.listBySession(sessionId)
+        : [];
+    const anchorStore = srcBackend.resumeAnchor();
+    const anchors = typeof anchorStore.listBySession === "function"
+        ? await anchorStore.listBySession(sessionId)
+        : [];
+    const getBlobFn = fs.getBlob?.bind(fs);
+    const getBlob = getBlobFn ? (hash) => getBlobFn(hash) : async () => undefined;
+    return { bundle: { sessionId, entries, snapshots, policy, anchors }, getBlob };
+}
+export async function exportSessionManifest(sessionId, srcBackend) {
+    const session = ownerAware(srcBackend);
+    const listEntryIds = session.listEntryIds?.bind(session);
+    if (!listEntryIds)
+        return null;
+    const entryIds = await listEntryIds(sessionId);
+    if (entryIds === null)
+        return null;
+    const getLeafId = session.getLeafId?.bind(session);
+    const leafId = getLeafId ? await getLeafId(sessionId) : null;
+    const fs = srcBackend.fileSnapshot();
+    const snapshots = [];
+    if (typeof fs.listKeys === "function" && typeof fs.exportManifest === "function") {
+        const keys = await fs.listKeys(sessionId);
+        for (const key of keys) {
+            const manifest = await fs.exportManifest(sessionId, key);
+            if (manifest === null)
+                continue;
+            snapshots.push({ key, manifest: [...manifest] });
+        }
+    }
+    const policyStore = srcBackend.sessionPolicy();
+    const policy = typeof policyStore.listBySession === "function"
+        ? await policyStore.listBySession(sessionId)
+        : [];
+    const anchorStore = srcBackend.resumeAnchor();
+    const anchors = typeof anchorStore.listBySession === "function"
+        ? await anchorStore.listBySession(sessionId)
+        : [];
+    const getBlobFn = fs.getBlob?.bind(fs);
+    const getBlob = getBlobFn ? (hash) => getBlobFn(hash) : async () => undefined;
+    return {
+        manifest: { sessionId, entryIds, entryCount: entryIds.length, leafId, snapshots, policy, anchors },
+        getBlob,
+    };
+}
+export async function importSession(bundle, getBlob, dstBackend, importingPrincipal, opts) {
+    const sessionId = bundle.sessionId;
+    const fs = dstBackend.fileSnapshot();
+    const canImportSnapshots = typeof fs.importManifest === "function";
+    const dstEntries = (await ownerAware(dstBackend).exportEntries?.(sessionId)) ?? null;
+    const rel = classifySyncRelationship(bundle.entries, dstEntries);
+    if ((rel.relation === "fork" || rel.relation === "stale") && opts?.resolution !== "overwrite-dst") {
+        throw new SyncConflictError(sessionId, rel);
+    }
+    validateEntriesForImport(bundle.entries);
+    if (canImportSnapshots) {
+        const distinct = new Set();
+        for (const snap of bundle.snapshots)
+            for (const [, hash] of snap.manifest)
+                distinct.add(hash);
+        for (const hash of distinct) {
+            const bytes = await getBlob(hash);
+            if (!bytes) {
+                throw new Error(`session-sync import: missing blob ${hash} for session ${sessionId} (refusing a partial-tree import)`);
+            }
+        }
+    }
+    let snapshotsImported = 0;
+    let snapshotsSkipped = 0;
+    if (canImportSnapshots) {
+        const importManifest = fs.importManifest.bind(fs);
+        for (const snap of bundle.snapshots) {
+            const r = await importManifest(sessionId, snap.key, new Map(snap.manifest), getBlob);
+            if (!r.ok) {
+                throw new Error(`session-sync import: snapshot import failed for session ${sessionId} key ${snap.key} (${r.error.code}: ${r.error.message}) — fail-closed, refusing a partial-tree import`);
+            }
+            snapshotsImported++;
+        }
+    }
+    else {
+        snapshotsSkipped = bundle.snapshots.length;
+    }
+    if (rel.relation !== "identical") {
+        const session = ownerAware(dstBackend);
+        const replaceEntries = session.replaceEntries?.bind(session);
+        if (!replaceEntries) {
+            throw new Error(`session-sync import: destination backend (${dstBackend.kind}) has no replaceEntries seam`);
+        }
+        await replaceEntries(sessionId, importingPrincipal, bundle.entries);
+    }
+    const policyStore = dstBackend.sessionPolicy();
+    for (const rec of bundle.policy) {
+        await policyStore.putRules(sessionId, rec.principal, rec.rules, { operator: opts?.operatorOk === true });
+    }
+    const anchorStore = dstBackend.resumeAnchor();
+    for (const a of bundle.anchors) {
+        await anchorStore.put(sessionId, a.eventId, a.entryId, importingPrincipal);
+    }
+    return { snapshotsImported, snapshotsSkipped, relation: rel.relation };
+}
+export async function planSync(sessionId, srcBackend, dstBackend) {
+    const srcEntries = (await ownerAware(srcBackend).exportEntries?.(sessionId)) ?? null;
+    if (srcEntries === null)
+        return null;
+    const dstEntries = (await ownerAware(dstBackend).exportEntries?.(sessionId)) ?? null;
+    return classifySyncRelationship(srcEntries, dstEntries);
+}
+//# sourceMappingURL=session-sync.js.map

package/dist/session-sync.js.map

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

package/dist/session-titler.d.ts

@@ -0,0 +1,30 @@
+export interface SessionTitlerDeps {
+    redact?: (text: string) => string;
+    setTitleIfNull(sessionId: string, title: string): Promise<boolean>;
+    probeTitle(sessionId: string): Promise<"none" | "untitled" | "titled">;
+    llm(opts: {
+        prompt: string;
+        timeoutMs: number;
+    }): Promise<{
+        ok: true;
+        text: string;
+    } | {
+        ok: false;
+        error: string;
+    }>;
+    logger?: {
+        info?(msg: string, meta?: unknown): void;
+        warn?(msg: string, meta?: unknown): void;
+    };
+    metrics?: {
+        inc(name: string, labels?: Record<string, string>): void;
+    };
+}
+export interface SessionTitler {
+    maybeTitle(sessionId: string, objective: string): void;
+}
+export declare const TITLE_MAX_CHARS = 80;
+export declare function sanitizeTitle(raw: string): string;
+export declare function buildTitlePrompt(objective: string): string;
+export declare function createSessionTitler(deps: SessionTitlerDeps): SessionTitler;
+//# sourceMappingURL=session-titler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-titler.d.ts","sourceRoot":"","sources":["../src/session-titler.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,iBAAiB;IAIhC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAElC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAMnE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC,CAAC;IAEvE,GAAG,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrH,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;IAChG,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC;CACxE;AAED,MAAM,WAAW,aAAa;IAE5B,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACxD;AAED,eAAO,MAAM,eAAe,KAAK,CAAC;AASlC,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAc1D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAwD1E"}

package/dist/session-titler.js

@@ -0,0 +1,77 @@
+export const TITLE_MAX_CHARS = 80;
+const OBJECTIVE_SNIPPET_CHARS = 600;
+const LLM_TIMEOUT_MS = 15_000;
+const NO_ROW_RETRY_MS = 20_000;
+const SEEN_CAP = 10_000;
+export function sanitizeTitle(raw) {
+    const oneLine = raw.replace(/[\r\n]+/g, " ").replace(/[\u0000-\u001f\u007f\u200e\u200f\u202a-\u202e\u2066-\u2069]/g, "").trim();
+    const unquoted = oneLine.replace(/^["'「『]+/, "").replace(/["'」』]+$/, "").trim();
+    return unquoted.length > TITLE_MAX_CHARS ? `${unquoted.slice(0, TITLE_MAX_CHARS - 1)}…` : unquoted;
+}
+export function buildTitlePrompt(objective) {
+    const snippet = objective.length > OBJECTIVE_SNIPPET_CHARS ? `${objective.slice(0, OBJECTIVE_SNIPPET_CHARS)}…` : objective;
+    const fenced = snippet.replace(/<(\/?)request>/gi, "<\u200b$1request>");
+    return ("Write a short title (at most 8 words) summarizing the user request below. " +
+        "Reply with ONLY the title on a single line — no quotes, no preamble. " +
+        "Use the same language as the request.\n\n<request>\n" +
+        fenced +
+        "\n</request>");
+}
+export function createSessionTitler(deps) {
+    const seen = new Set();
+    return {
+        maybeTitle(sessionId, objective) {
+            if (!sessionId || !objective.trim())
+                return;
+            if (seen.has(sessionId))
+                return;
+            if (seen.size >= SEEN_CAP) {
+                const oldest = seen.values().next().value;
+                if (oldest !== undefined)
+                    seen.delete(oldest);
+            }
+            seen.add(sessionId);
+            void (async () => {
+                let state = await deps.probeTitle(sessionId).catch(() => "untitled");
+                if (state === "none") {
+                    await new Promise((r) => setTimeout(r, NO_ROW_RETRY_MS));
+                    state = await deps.probeTitle(sessionId).catch(() => "untitled");
+                    if (state === "none") {
+                        seen.delete(sessionId);
+                        deps.metrics?.inc("session_title_total", { outcome: "row_not_yet" });
+                        return;
+                    }
+                }
+                if (state === "titled") {
+                    deps.metrics?.inc("session_title_total", { outcome: "already_titled" });
+                    return;
+                }
+                const r = await deps.llm({ prompt: buildTitlePrompt(objective), timeoutMs: LLM_TIMEOUT_MS });
+                if (!r.ok) {
+                    deps.metrics?.inc("session_title_total", { outcome: "llm_failed" });
+                    deps.logger?.warn?.("session_title_failed", { sessionId, error: r.error.slice(0, 200) });
+                    return;
+                }
+                const title = sanitizeTitle(deps.redact ? deps.redact(r.text) : r.text);
+                if (!title) {
+                    deps.metrics?.inc("session_title_total", { outcome: "empty" });
+                    return;
+                }
+                const landed = await deps.setTitleIfNull(sessionId, title);
+                if (!landed) {
+                    const after = await deps.probeTitle(sessionId).catch(() => "titled");
+                    if (after === "none")
+                        seen.delete(sessionId);
+                    deps.metrics?.inc("session_title_total", { outcome: after === "none" ? "row_not_yet" : "already_titled" });
+                    return;
+                }
+                deps.metrics?.inc("session_title_total", { outcome: "set" });
+                deps.logger?.info?.("session_titled", { sessionId, titleChars: title.length });
+            })().catch((e) => {
+                deps.metrics?.inc("session_title_total", { outcome: "error" });
+                deps.logger?.warn?.("session_title_failed", { sessionId, error: String(e).slice(0, 200) });
+            });
+        },
+    };
+}
+//# sourceMappingURL=session-titler.js.map

package/dist/session-titler.js.map

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

package/dist/spec-fields.d.ts

@@ -0,0 +1,5 @@
+import type { TaskSpec } from "@sema-agent/core";
+export declare function normalizeSuggestNextPrompts(v: unknown): TaskSpec["suggestNextPrompts"];
+export declare function normalizeResilience(v: unknown, operator: boolean): TaskSpec["resilience"];
+export declare function normalizeAttachments(v: unknown): TaskSpec["attachments"];
+//# sourceMappingURL=spec-fields.d.ts.map

package/dist/spec-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-fields.d.ts","sourceRoot":"","sources":["../src/spec-fields.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAOjD,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,oBAAoB,CAAC,CAUtF;AAWD,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC,YAAY,CAAC,CASzF;AAUD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,CAoBxE"}

package/dist/spec-fields.js

@@ -0,0 +1,43 @@
+export function normalizeSuggestNextPrompts(v) {
+    if (v === true)
+        return true;
+    if (v == null || typeof v !== "object" || Array.isArray(v))
+        return undefined;
+    const o = v;
+    const count = typeof o.count === "number" && Number.isFinite(o.count) && o.count >= 1 ? Math.min(10, Math.floor(o.count)) : undefined;
+    const role = typeof o.role === "string" && o.role ? o.role : undefined;
+    return { ...(count !== undefined ? { count } : {}), ...(role ? { role } : {}) };
+}
+export function normalizeResilience(v, operator) {
+    if (v == null || typeof v !== "object" || Array.isArray(v))
+        return undefined;
+    const o = v;
+    const out = {
+        ...(typeof o.allowDegrade === "boolean" ? { allowDegrade: o.allowDegrade } : {}),
+        ...(typeof o.allowFailover === "boolean" ? { allowFailover: o.allowFailover } : {}),
+        ...(o.bypassBreaker === true && operator ? { bypassBreaker: true } : {}),
+    };
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+export function normalizeAttachments(v) {
+    if (v == null || typeof v !== "object" || Array.isArray(v))
+        return undefined;
+    const o = v;
+    let changedFiles;
+    if (o.changedFiles === true)
+        changedFiles = true;
+    else if (o.changedFiles != null && typeof o.changedFiles === "object" && !Array.isArray(o.changedFiles)) {
+        const mf = o.changedFiles.maxFiles;
+        changedFiles =
+            typeof mf === "number" && Number.isFinite(mf) && mf >= 1 ? { maxFiles: Math.min(100, Math.floor(mf)) } : true;
+    }
+    const out = {
+        ...(o.todoReminder === true ? { todoReminder: true } : {}),
+        ...(changedFiles !== undefined ? { changedFiles } : {}),
+        ...(o.planModeReminder === true ? { planModeReminder: true } : {}),
+        ...(o.backgroundTasks === true ? { backgroundTasks: true } : {}),
+        ...(o.toolsDelta === true ? { toolsDelta: true } : {}),
+    };
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+//# sourceMappingURL=spec-fields.js.map

package/dist/spec-fields.js.map

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

package/dist/task-cwd.d.ts

@@ -0,0 +1,15 @@
+export declare const MAX_CWD_CHARS = 4096;
+export declare function isValidCwd(cwd: unknown): cwd is string;
+export declare function cwdHonored(config: {
+    remoteExec?: {
+        provider?: string;
+    };
+    requirePrincipal?: boolean;
+}): boolean;
+export declare const MAX_ADDITIONAL_DIRS = 64;
+export declare function parseAdditionalDirectories(raw: unknown): string[] | undefined;
+export declare function effectiveHostWorkspace(sessionCwd: string | undefined, ctx: {
+    isolation?: string;
+    parentCwd?: string;
+}): string | undefined;
+//# sourceMappingURL=task-cwd.d.ts.map

package/dist/task-cwd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-cwd.d.ts","sourceRoot":"","sources":["../src/task-cwd.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,aAAa,OAAQ,CAAC;AAQnC,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAStD;AAMD,wBAAgB,UAAU,CAAC,MAAM,EAAE;IAAE,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAE9G;AAGD,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAYtC,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,GAAG,SAAS,CAW7E;AAeD,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,GAAG,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,MAAM,GAAG,SAAS,CAEpB"}

package/dist/task-cwd.js

@@ -0,0 +1,33 @@
+import path from "node:path";
+export const MAX_CWD_CHARS = 4_096;
+export function isValidCwd(cwd) {
+    return (typeof cwd === "string" &&
+        cwd.length > 0 &&
+        cwd.length <= MAX_CWD_CHARS &&
+        !cwd.includes("\0") &&
+        path.isAbsolute(cwd) &&
+        !cwd.split(/[/\\]/).includes(".."));
+}
+export function cwdHonored(config) {
+    return config.remoteExec?.provider === "host" && config.requirePrincipal !== true;
+}
+export const MAX_ADDITIONAL_DIRS = 64;
+export function parseAdditionalDirectories(raw) {
+    if (!Array.isArray(raw))
+        return undefined;
+    const out = [];
+    const seen = new Set();
+    for (const entry of raw) {
+        if (out.length >= MAX_ADDITIONAL_DIRS)
+            break;
+        if (!isValidCwd(entry) || seen.has(entry))
+            continue;
+        seen.add(entry);
+        out.push(entry);
+    }
+    return out.length > 0 ? out : undefined;
+}
+export function effectiveHostWorkspace(sessionCwd, ctx) {
+    return sessionCwd ?? (ctx.isolation !== "worktree" ? ctx.parentCwd : undefined);
+}
+//# sourceMappingURL=task-cwd.js.map

package/dist/task-cwd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-cwd.js","sourceRoot":"","sources":["../src/task-cwd.ts"],"names":[],"mappings":"AAiBA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AAQnC,MAAM,UAAU,UAAU,CAAC,GAAY;IACrC,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,CAAC,MAAM,GAAG,CAAC;QACd,GAAG,CAAC,MAAM,IAAI,aAAa;QAC3B,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QACnB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QACpB,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CACnC,CAAC;AACJ,CAAC;AAMD,MAAM,UAAU,UAAU,CAAC,MAA0E;IACnG,OAAO,MAAM,CAAC,UAAU,EAAE,QAAQ,KAAK,MAAM,IAAI,MAAM,CAAC,gBAAgB,KAAK,IAAI,CAAC;AACpF,CAAC;AAGD,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAYtC,MAAM,UAAU,0BAA0B,CAAC,GAAY;IACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;QACxB,IAAI,GAAG,CAAC,MAAM,IAAI,mBAAmB;YAAE,MAAM;QAC7C,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QACpD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1C,CAAC;AAeD,MAAM,UAAU,sBAAsB,CACpC,UAA8B,EAC9B,GAA+C;IAE/C,OAAO,UAAU,IAAI,CAAC,GAAG,CAAC,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAClF,CAAC"}

package/dist/task-mcp.d.ts

@@ -0,0 +1,20 @@
+import type { McpServerSpec } from "@sema-agent/core";
+export declare const MAX_REQUEST_MCP_SERVERS = 32;
+export declare function mcpInjectionHonored(config: {
+    requirePrincipal?: boolean;
+}): boolean;
+export declare function validateRequestMcp(raw: unknown): {
+    ok: McpServerSpec[];
+    dropped: string[];
+} | null;
+export declare function mergeRequestMcp(baseline: McpServerSpec[] | undefined, gated: McpServerSpec[]): McpServerSpec[] | undefined;
+export declare function resolveRequestMcp(baseline: McpServerSpec[] | undefined, bodyMcp: unknown, config: {
+    remoteExec?: {
+        provider?: string;
+    };
+    requirePrincipal?: boolean;
+}, logger?: {
+    info?(m: string, meta?: unknown): void;
+    warn(m: string, meta?: unknown): void;
+}): McpServerSpec[] | undefined;
+//# sourceMappingURL=task-mcp.d.ts.map

package/dist/task-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-mcp.d.ts","sourceRoot":"","sources":["../src/task-mcp.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAS1C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAEnF;AA+CD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,aAAa,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAYlG;AAOD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,GAAG,SAAS,CAK1H;AAQD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,aAAa,EAAE,GAAG,SAAS,EACrC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE;IAAE,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,EAC1E,MAAM,CAAC,EAAE;IAAE,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE,GACzF,aAAa,EAAE,GAAG,SAAS,CAc7B"}

package/dist/task-mcp.js

@@ -0,0 +1,93 @@
+export const MAX_REQUEST_MCP_SERVERS = 32;
+export function mcpInjectionHonored(config) {
+    return config.requirePrincipal !== true;
+}
+function isStringRecord(v) {
+    return !!v && typeof v === "object" && !Array.isArray(v) && Object.values(v).every((x) => typeof x === "string");
+}
+function normalizeServer(e) {
+    if (!e || typeof e !== "object")
+        return null;
+    const o = e;
+    if (typeof o.name !== "string" || o.name.length === 0 || o.name.length > 128)
+        return null;
+    const t = o.transport;
+    if (!t || typeof t !== "object")
+        return null;
+    const tr = t;
+    let transport;
+    if (tr.kind === "stdio") {
+        if (typeof tr.command !== "string" || tr.command.length === 0)
+            return null;
+        transport = {
+            kind: "stdio",
+            command: tr.command,
+            ...(Array.isArray(tr.args) && tr.args.every((a) => typeof a === "string") ? { args: tr.args } : {}),
+            ...(isStringRecord(tr.env) ? { env: tr.env } : {}),
+        };
+    }
+    else if (tr.kind === "http") {
+        if (typeof tr.url !== "string" || !/^https?:\/\//i.test(tr.url))
+            return null;
+        transport = {
+            kind: "http",
+            url: tr.url,
+            ...(isStringRecord(tr.headers) ? { headers: tr.headers } : {}),
+            ...(typeof tr.principalHeader === "string" ? { principalHeader: tr.principalHeader } : {}),
+        };
+    }
+    else {
+        return null;
+    }
+    const spec = { name: o.name, transport };
+    if (Array.isArray(o.allowTools) && o.allowTools.every((a) => typeof a === "string"))
+        spec.allowTools = o.allowTools;
+    if (typeof o.elicitation === "boolean")
+        spec.elicitation = o.elicitation;
+    if (o.toolAxes && typeof o.toolAxes === "object" && !Array.isArray(o.toolAxes))
+        spec.toolAxes = o.toolAxes;
+    return spec;
+}
+export function validateRequestMcp(raw) {
+    if (raw === undefined || raw === null)
+        return { ok: [], dropped: [] };
+    if (!Array.isArray(raw))
+        return null;
+    const ok = [];
+    const dropped = [];
+    for (const e of raw.slice(0, MAX_REQUEST_MCP_SERVERS)) {
+        const v = normalizeServer(e);
+        if (v)
+            ok.push(v);
+        else
+            dropped.push(e && typeof e === "object" && typeof e.name === "string" ? String(e.name) : "<malformed>");
+    }
+    if (raw.length > MAX_REQUEST_MCP_SERVERS)
+        dropped.push(`(+${raw.length - MAX_REQUEST_MCP_SERVERS} over cap of ${MAX_REQUEST_MCP_SERVERS})`);
+    return { ok, dropped };
+}
+export function mergeRequestMcp(baseline, gated) {
+    if (gated.length === 0)
+        return baseline;
+    const taken = new Set((baseline ?? []).map((s) => s.name));
+    const add = gated.filter((s) => !taken.has(s.name));
+    return add.length === 0 ? baseline : [...(baseline ?? []), ...add];
+}
+export function resolveRequestMcp(baseline, bodyMcp, config, logger) {
+    if (bodyMcp === undefined || bodyMcp === null)
+        return baseline;
+    const honored = mcpInjectionHonored(config);
+    if (!honored) {
+        logger?.warn("mcp_injection_ignored", { reason: "gate_closed (per-request MCP honored only on single-user host lane)" });
+        return baseline;
+    }
+    const v = validateRequestMcp(bodyMcp);
+    if (v === null) {
+        logger?.warn("mcp_injection_ignored", { reason: "mcpServers not an array" });
+        return baseline;
+    }
+    if (v.dropped.length > 0)
+        logger?.warn("mcp_injection_dropped", { dropped: v.dropped });
+    return mergeRequestMcp(baseline, v.ok);
+}
+//# sourceMappingURL=task-mcp.js.map

package/dist/task-mcp.js.map

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

package/dist/task-settings.d.ts

@@ -0,0 +1,36 @@
+import { type TaskSpec, type ThinkingLevel, type ToolPolicy } from "@sema-agent/core";
+import type { HooksConfig } from "@sema-agent/registry-core/hooks";
+export type SettingsPermissionMode = "default" | "acceptEdits" | "plan";
+export declare function coercePermissionMode(raw: unknown): SettingsPermissionMode | undefined;
+export declare function effectiveThinking(reasoningEffort: unknown, ultracode: boolean): ThinkingLevel | undefined;
+export declare function withPermissionMode(settings: ParsedTaskSettings | undefined, mode: SettingsPermissionMode): ParsedTaskSettings;
+export interface ParsedTaskSettings {
+    permissions?: {
+        allow?: string[];
+        deny?: string[];
+        ask?: string[];
+        defaultMode?: SettingsPermissionMode;
+    };
+    model?: string;
+    outputStyle?: string;
+    shellEnv?: Record<string, string>;
+    ultracode?: boolean;
+    hooks?: HooksConfig;
+}
+export interface ParseTaskSettingsResult {
+    settings?: ParsedTaskSettings;
+    deferred: string[];
+}
+export declare const MAX_SETTINGS_OUTPUT_STYLE_CHARS = 16384;
+export declare const MAX_SETTINGS_PERMISSION_RULES = 1000;
+export declare const MAX_SETTINGS_ENV_VARS = 256;
+export declare const MAX_SETTINGS_ENV_VALUE_CHARS = 32768;
+export declare const MAX_SETTINGS_ENV_KEY_CHARS = 256;
+export declare function parseTaskSettings(raw: unknown): ParseTaskSettingsResult;
+export declare function deriveSettingsPolicy(settings: ParsedTaskSettings): {
+    toolPolicy?: ToolPolicy;
+    handsReadOnly?: boolean;
+    enablePlanMode?: boolean;
+};
+export declare function applyTaskSettings(base: TaskSpec, settings: ParsedTaskSettings): TaskSpec;
+//# sourceMappingURL=task-settings.d.ts.map

package/dist/task-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-settings.d.ts","sourceRoot":"","sources":["../src/task-settings.ts"],"names":[],"mappings":"AAqCA,OAAO,EAQL,KAAK,QAAQ,EACb,KAAK,aAAa,EAGlB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAKnE,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,aAAa,GAAG,MAAM,CAAC;AAUxE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,sBAAsB,GAAG,SAAS,CAIrF;AAMD,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAKzG;AAKD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,EAAE,IAAI,EAAE,sBAAsB,GAAG,kBAAkB,CAG7H;AAKD,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAEhB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QACf,WAAW,CAAC,EAAE,sBAAsB,CAAC;KACtC,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IAKrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAIlC,SAAS,CAAC,EAAE,OAAO,CAAC;IAIpB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAID,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAG9B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAKD,eAAO,MAAM,+BAA+B,QAAS,CAAC;AAEtD,eAAO,MAAM,6BAA6B,OAAQ,CAAC;AAEnD,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,4BAA4B,QAAS,CAAC;AACnD,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAmC9C,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,uBAAuB,CAiDvE;AAiCD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,kBAAkB,GAC3B;IAAE,UAAU,CAAC,EAAE,UAAU,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,CA+BhF;AAYD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,GAAG,QAAQ,CAsBxF"}