@seawork/server 1.0.0

package/dist/server/server/agent/agent-projections.js

@@ -0,0 +1,280 @@
+function normalizeThinkingOptionId(value) {
+    if (typeof value !== "string")
+        return null;
+    const normalized = value.trim();
+    return normalized.length > 0 ? normalized : null;
+}
+export function resolveEffectiveThinkingOptionId(options) {
+    const runtimeInfo = options.runtimeInfo;
+    if (runtimeInfo && "thinkingOptionId" in runtimeInfo) {
+        return normalizeThinkingOptionId(runtimeInfo.thinkingOptionId);
+    }
+    return normalizeThinkingOptionId(options.configuredThinkingOptionId);
+}
+export function toStoredAgentRecord(agent, options) {
+    const createdAt = options?.createdAt ?? agent.createdAt.toISOString();
+    const config = buildSerializableConfig(agent.config);
+    const persistence = sanitizePersistenceHandle(agent.persistence);
+    const runtimeInfo = sanitizeRuntimeInfo(agent.runtimeInfo);
+    return {
+        id: agent.id,
+        provider: agent.provider,
+        cwd: agent.cwd,
+        createdAt,
+        updatedAt: agent.updatedAt.toISOString(),
+        lastActivityAt: agent.updatedAt.toISOString(),
+        lastUserMessageAt: agent.lastUserMessageAt ? agent.lastUserMessageAt.toISOString() : null,
+        title: options?.title ?? null,
+        labels: agent.labels,
+        lastStatus: agent.lifecycle,
+        lastModeId: agent.currentModeId ?? config?.modeId ?? null,
+        config: config ?? null,
+        runtimeInfo,
+        features: normalizeFeatures(agent.features),
+        persistence,
+        requiresAttention: agent.attention.requiresAttention,
+        attentionReason: agent.attention.requiresAttention ? agent.attention.attentionReason : null,
+        attentionTimestamp: agent.attention.requiresAttention
+            ? agent.attention.attentionTimestamp.toISOString()
+            : null,
+        internal: options?.internal,
+    };
+}
+export function toAgentPayload(agent, options) {
+    const runtimeInfo = sanitizeRuntimeInfo(agent.runtimeInfo);
+    const thinkingOptionId = agent.config.thinkingOptionId ?? null;
+    const effectiveThinkingOptionId = resolveEffectiveThinkingOptionId({
+        runtimeInfo,
+        configuredThinkingOptionId: thinkingOptionId,
+    });
+    const payload = {
+        id: agent.id,
+        provider: agent.provider,
+        cwd: agent.cwd,
+        model: agent.config.model ?? null,
+        thinkingOptionId,
+        effectiveThinkingOptionId,
+        runtimeInfo,
+        createdAt: agent.createdAt.toISOString(),
+        updatedAt: agent.updatedAt.toISOString(),
+        lastUserMessageAt: agent.lastUserMessageAt ? agent.lastUserMessageAt.toISOString() : null,
+        status: agent.lifecycle,
+        capabilities: cloneCapabilities(agent.capabilities),
+        currentModeId: agent.currentModeId,
+        availableModes: cloneAvailableModes(agent.availableModes),
+        features: normalizeFeatures(agent.features),
+        pendingPermissions: sanitizePendingPermissions(agent.pendingPermissions),
+        persistence: sanitizePersistenceHandle(agent.persistence),
+        title: options?.title ?? null,
+        labels: agent.labels,
+    };
+    const usage = sanitizeUsage(agent.lastUsage);
+    if (usage !== undefined) {
+        payload.lastUsage = usage;
+    }
+    if (agent.lastError !== undefined) {
+        payload.lastError = agent.lastError;
+    }
+    // Handle attention state
+    payload.requiresAttention = agent.attention.requiresAttention;
+    if (agent.attention.requiresAttention) {
+        payload.attentionReason = agent.attention.attentionReason;
+        payload.attentionTimestamp = agent.attention.attentionTimestamp.toISOString();
+    }
+    else {
+        payload.attentionReason = null;
+        payload.attentionTimestamp = null;
+    }
+    return payload;
+}
+function buildSerializableConfig(config) {
+    const serializable = {};
+    if (Object.prototype.hasOwnProperty.call(config, "title")) {
+        serializable.title = config.title ?? null;
+    }
+    if (config.modeId) {
+        serializable.modeId = config.modeId;
+    }
+    if (config.model) {
+        serializable.model = config.model;
+    }
+    if (config.thinkingOptionId) {
+        serializable.thinkingOptionId = config.thinkingOptionId;
+    }
+    if (Object.prototype.hasOwnProperty.call(config, "featureValues")) {
+        const featureValues = sanitizeMetadata(config.featureValues);
+        if (featureValues !== undefined) {
+            serializable.featureValues = featureValues;
+        }
+    }
+    const extra = sanitizeMetadata(config.extra);
+    if (extra !== undefined) {
+        serializable.extra = extra;
+    }
+    if (config.systemPrompt) {
+        serializable.systemPrompt = config.systemPrompt;
+    }
+    if (config.mcpServers) {
+        serializable.mcpServers = config.mcpServers;
+    }
+    return Object.keys(serializable).length ? serializable : null;
+}
+function sanitizePendingPermissions(pending) {
+    return Array.from(pending.values()).map((request) => ({
+        ...request,
+        input: sanitizeMetadata(request.input),
+        suggestions: sanitizeMetadataArray(request.suggestions),
+        actions: request.actions?.map((action) => ({ ...action })),
+        metadata: sanitizeMetadata(request.metadata),
+    }));
+}
+function sanitizePersistenceHandle(handle) {
+    if (!handle) {
+        return null;
+    }
+    const sanitized = {
+        provider: handle.provider,
+        sessionId: handle.sessionId,
+    };
+    if (handle.nativeHandle !== undefined) {
+        sanitized.nativeHandle = handle.nativeHandle;
+    }
+    const metadata = sanitizeMetadata(handle.metadata);
+    if (metadata !== undefined) {
+        sanitized.metadata = metadata;
+    }
+    return sanitized;
+}
+function cloneCapabilities(capabilities) {
+    return { ...capabilities };
+}
+function cloneAvailableModes(modes) {
+    return modes.map((mode) => ({ ...mode }));
+}
+function normalizeFeatures(features) {
+    return Array.isArray(features) ? features.map((feature) => ({ ...feature })) : [];
+}
+function sanitizeOptionalJson(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === null) {
+        return null;
+    }
+    if (Array.isArray(value)) {
+        const sanitized = value
+            .map((item) => sanitizeOptionalJson(item))
+            .filter((item) => item !== undefined);
+        return sanitized;
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (typeof value === "object") {
+        const result = {};
+        for (const [key, val] of Object.entries(value)) {
+            const sanitized = sanitizeOptionalJson(val);
+            if (sanitized !== undefined) {
+                result[key] = sanitized;
+            }
+        }
+        return Object.keys(result).length ? result : undefined;
+    }
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        return value;
+    }
+    return undefined;
+}
+function isJsonObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function sanitizeMetadata(value) {
+    const sanitized = sanitizeOptionalJson(value);
+    if (!sanitized || !isJsonObject(sanitized)) {
+        return undefined;
+    }
+    return sanitized;
+}
+function sanitizeMetadataArray(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const sanitized = value
+        .map((entry) => sanitizeMetadata(entry))
+        .filter((entry) => entry !== undefined);
+    return sanitized.length > 0 ? sanitized : undefined;
+}
+function sanitizeUsage(value) {
+    const sanitized = sanitizeOptionalJson(value);
+    if (!sanitized || !isJsonObject(sanitized)) {
+        return undefined;
+    }
+    const result = {};
+    const inputTokens = sanitized.inputTokens;
+    if (typeof inputTokens === "number" && Number.isFinite(inputTokens)) {
+        result.inputTokens = inputTokens;
+    }
+    else if (inputTokens !== undefined && inputTokens !== null) {
+        return undefined;
+    }
+    const cachedInputTokens = sanitized.cachedInputTokens;
+    if (typeof cachedInputTokens === "number" && Number.isFinite(cachedInputTokens)) {
+        result.cachedInputTokens = cachedInputTokens;
+    }
+    else if (cachedInputTokens !== undefined && cachedInputTokens !== null) {
+        return undefined;
+    }
+    const outputTokens = sanitized.outputTokens;
+    if (typeof outputTokens === "number" && Number.isFinite(outputTokens)) {
+        result.outputTokens = outputTokens;
+    }
+    else if (outputTokens !== undefined && outputTokens !== null) {
+        return undefined;
+    }
+    const totalCostUsd = sanitized.totalCostUsd;
+    if (typeof totalCostUsd === "number" && Number.isFinite(totalCostUsd)) {
+        result.totalCostUsd = totalCostUsd;
+    }
+    else if (totalCostUsd !== undefined && totalCostUsd !== null) {
+        return undefined;
+    }
+    const contextWindowMaxTokens = sanitized.contextWindowMaxTokens;
+    if (typeof contextWindowMaxTokens === "number" && Number.isFinite(contextWindowMaxTokens)) {
+        result.contextWindowMaxTokens = contextWindowMaxTokens;
+    }
+    else if (contextWindowMaxTokens !== undefined && contextWindowMaxTokens !== null) {
+        return undefined;
+    }
+    const contextWindowUsedTokens = sanitized.contextWindowUsedTokens;
+    if (typeof contextWindowUsedTokens === "number" && Number.isFinite(contextWindowUsedTokens)) {
+        result.contextWindowUsedTokens = contextWindowUsedTokens;
+    }
+    else if (contextWindowUsedTokens !== undefined && contextWindowUsedTokens !== null) {
+        return undefined;
+    }
+    return Object.keys(result).length ? result : undefined;
+}
+function sanitizeRuntimeInfo(runtimeInfo) {
+    if (!runtimeInfo) {
+        return undefined;
+    }
+    const sanitized = {
+        provider: runtimeInfo.provider,
+        sessionId: runtimeInfo.sessionId,
+    };
+    if (runtimeInfo.model !== undefined) {
+        sanitized.model = runtimeInfo.model;
+    }
+    if (runtimeInfo.thinkingOptionId !== undefined) {
+        sanitized.thinkingOptionId = runtimeInfo.thinkingOptionId;
+    }
+    if (runtimeInfo.modeId !== undefined) {
+        sanitized.modeId = runtimeInfo.modeId;
+    }
+    const extra = sanitizeMetadata(runtimeInfo.extra);
+    if (extra !== undefined) {
+        sanitized.extra = extra;
+    }
+    return sanitized;
+}
+//# sourceMappingURL=agent-projections.js.map

package/dist/server/server/agent/agent-projections.js.map

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

package/dist/server/server/agent/agent-response-loop.d.ts

@@ -0,0 +1,60 @@
+import { z } from "zod";
+import type { AgentProvider, AgentSessionConfig } from "./agent-sdk-types.js";
+import type { AgentManager } from "./agent-manager.js";
+export type JsonSchema = Record<string, unknown>;
+export type AgentCaller = (prompt: string) => Promise<string>;
+export declare class StructuredAgentResponseError extends Error {
+    readonly lastResponse: string;
+    readonly validationErrors: string[];
+    constructor(message: string, options: {
+        lastResponse: string;
+        validationErrors: string[];
+    });
+}
+export type StructuredGenerationProvider = {
+    provider: AgentProvider;
+    model?: string;
+    thinkingOptionId?: string;
+};
+export type StructuredGenerationAttempt = {
+    provider: AgentProvider;
+    model: string | null;
+    available: boolean;
+    error: string | null;
+};
+export declare class StructuredAgentFallbackError extends Error {
+    readonly attempts: StructuredGenerationAttempt[];
+    constructor(attempts: StructuredGenerationAttempt[]);
+}
+export interface StructuredAgentResponseOptions<T> {
+    caller: AgentCaller;
+    prompt: string;
+    schema: z.ZodType<T> | JsonSchema;
+    maxRetries?: number;
+    schemaName?: string;
+}
+export interface StructuredAgentGenerationOptions<T> {
+    manager: AgentManager;
+    agentConfig: AgentSessionConfig;
+    agentId?: string;
+    prompt: string;
+    schema: z.ZodType<T> | JsonSchema;
+    maxRetries?: number;
+    schemaName?: string;
+}
+export interface StructuredAgentGenerationWithFallbackOptions<T> {
+    manager: AgentManager;
+    cwd: string;
+    prompt: string;
+    schema: z.ZodType<T> | JsonSchema;
+    providers: readonly StructuredGenerationProvider[];
+    agentConfigOverrides?: Omit<AgentSessionConfig, "provider" | "cwd" | "model" | "thinkingOptionId">;
+    maxRetries?: number;
+    schemaName?: string;
+    runner?: <TResult>(options: StructuredAgentGenerationOptions<TResult>) => Promise<TResult>;
+}
+export declare const DEFAULT_STRUCTURED_GENERATION_PROVIDERS: readonly StructuredGenerationProvider[];
+export declare function getStructuredAgentResponse<T>(options: StructuredAgentResponseOptions<T>): Promise<T>;
+export declare function generateStructuredAgentResponse<T>(options: StructuredAgentGenerationOptions<T>): Promise<T>;
+export declare function generateStructuredAgentResponseWithFallback<T>(options: StructuredAgentGenerationWithFallbackOptions<T>): Promise<T>;
+//# sourceMappingURL=agent-response-loop.d.ts.map

package/dist/server/server/agent/agent-response-loop.d.ts.map

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

package/dist/server/server/agent/agent-response-loop.js

@@ -0,0 +1,304 @@
+import { zodToJsonSchema } from "zod-to-json-schema";
+import Ajv from "ajv";
+import { getAgentProviderDefinition } from "./provider-manifest.js";
+export class StructuredAgentResponseError extends Error {
+    constructor(message, options) {
+        super(message);
+        this.name = "StructuredAgentResponseError";
+        this.lastResponse = options.lastResponse;
+        this.validationErrors = options.validationErrors;
+    }
+}
+export class StructuredAgentFallbackError extends Error {
+    constructor(attempts) {
+        const summary = attempts
+            .map((attempt) => {
+            const modelSuffix = attempt.model ? ` (${attempt.model})` : "";
+            if (!attempt.available) {
+                return `${attempt.provider}${modelSuffix}: unavailable${attempt.error ? ` (${attempt.error})` : ""}`;
+            }
+            return `${attempt.provider}${modelSuffix}: failed${attempt.error ? ` (${attempt.error})` : ""}`;
+        })
+            .join("; ");
+        super(summary.length > 0
+            ? `Structured generation failed for all providers: ${summary}`
+            : "Structured generation failed for all providers");
+        this.name = "StructuredAgentFallbackError";
+        this.attempts = attempts;
+    }
+}
+export const DEFAULT_STRUCTURED_GENERATION_PROVIDERS = [
+    { provider: "claude", model: "haiku" },
+    { provider: "codex", model: "gpt-5.4-mini", thinkingOptionId: "low" },
+    { provider: "opencode", model: "opencode/gpt-5-nano" },
+];
+function isZodSchema(value) {
+    return typeof value?.safeParse === "function";
+}
+function buildZodValidator(schema, schemaName) {
+    const zodToJsonSchemaAny = zodToJsonSchema;
+    const jsonSchema = zodToJsonSchemaAny(schema, schemaName);
+    return {
+        jsonSchema,
+        validate: (value) => {
+            const result = schema.safeParse(value);
+            if (result.success) {
+                return { ok: true, value: result.data };
+            }
+            const errors = result.error.issues.map((issue) => {
+                const path = issue.path.length > 0 ? issue.path.join(".") : "(root)";
+                return `${path}: ${issue.message}`;
+            });
+            return { ok: false, errors };
+        },
+    };
+}
+function buildJsonSchemaValidator(schema) {
+    const AjvConstructor = Ajv;
+    const ajv = new AjvConstructor({ allErrors: true, strict: false });
+    const validate = ajv.compile(schema);
+    return {
+        jsonSchema: schema,
+        validate: (value) => {
+            const ok = validate(value);
+            if (ok) {
+                return { ok: true, value: value };
+            }
+            const errors = (validate.errors ?? []).map((error) => {
+                const path = error.instancePath && error.instancePath.length > 0 ? error.instancePath : "(root)";
+                const message = error.message ?? "is invalid";
+                return `${path}: ${message}`;
+            });
+            return { ok: false, errors };
+        },
+    };
+}
+function buildValidator(schema, schemaName) {
+    if (isZodSchema(schema)) {
+        return buildZodValidator(schema, schemaName);
+    }
+    return buildJsonSchemaValidator(schema);
+}
+function buildBasePrompt(prompt, jsonSchema) {
+    const schemaText = JSON.stringify(jsonSchema, null, 2);
+    return [
+        prompt.trim(),
+        "",
+        "You must respond with JSON only that matches this JSON Schema:",
+        schemaText,
+    ].join("\n");
+}
+function buildRetryPrompt(basePrompt, errors) {
+    const formattedErrors = errors.map((error) => `- ${error}`).join("\n");
+    return [
+        basePrompt,
+        "",
+        "Previous response was invalid with validation errors:",
+        formattedErrors.length > 0 ? formattedErrors : "- Unknown validation error",
+        "",
+        "Respond again with JSON only that matches the schema.",
+    ].join("\n");
+}
+function extractJsonFromMarkdown(text) {
+    const fencedMatch = text.match(/```(?:json)?\s*\n([\s\S]*?)\n```/);
+    if (fencedMatch) {
+        return fencedMatch[1].trim();
+    }
+    const extracted = extractFirstJsonSnippet(text);
+    if (extracted) {
+        return extracted;
+    }
+    return text.trim();
+}
+function extractFirstJsonSnippet(text) {
+    const source = text.trim();
+    if (!source) {
+        return null;
+    }
+    // Try to find the first valid JSON object/array within a larger response.
+    // This is intentionally provider-agnostic and improves resilience when models
+    // add extra prose before/after the JSON.
+    const startIndexes = [];
+    for (let i = 0; i < source.length; i += 1) {
+        const ch = source[i];
+        if (ch === "{" || ch === "[") {
+            startIndexes.push(i);
+        }
+    }
+    for (const start of startIndexes) {
+        const open = source[start];
+        const close = open === "{" ? "}" : "]";
+        let depth = 0;
+        let inString = false;
+        let escaped = false;
+        for (let i = start; i < source.length; i += 1) {
+            const ch = source[i];
+            if (inString) {
+                if (escaped) {
+                    escaped = false;
+                    continue;
+                }
+                if (ch === "\\") {
+                    escaped = true;
+                    continue;
+                }
+                if (ch === '"') {
+                    inString = false;
+                }
+                continue;
+            }
+            if (ch === '"') {
+                inString = true;
+                continue;
+            }
+            if (ch === open) {
+                depth += 1;
+                continue;
+            }
+            if (ch === close) {
+                depth -= 1;
+                if (depth === 0) {
+                    const candidate = source.slice(start, i + 1).trim();
+                    try {
+                        JSON.parse(candidate);
+                        return candidate;
+                    }
+                    catch {
+                        // keep scanning; the snippet might not be JSON (e.g. braces in prose)
+                    }
+                }
+            }
+        }
+    }
+    return null;
+}
+export async function getStructuredAgentResponse(options) {
+    const { caller, prompt, schema, maxRetries = 2, schemaName = "Response" } = options;
+    const validator = buildValidator(schema, schemaName);
+    const basePrompt = buildBasePrompt(prompt, validator.jsonSchema);
+    let attemptPrompt = basePrompt;
+    let lastResponse = "";
+    let lastErrors = [];
+    for (let attempt = 0; attempt <= maxRetries; attempt += 1) {
+        const response = await caller(attemptPrompt);
+        lastResponse = response;
+        const jsonText = extractJsonFromMarkdown(response);
+        let parsed;
+        try {
+            parsed = JSON.parse(jsonText);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            lastErrors = [`Invalid JSON: ${message}`];
+            if (attempt === maxRetries) {
+                break;
+            }
+            attemptPrompt = buildRetryPrompt(basePrompt, lastErrors);
+            continue;
+        }
+        const validation = validator.validate(parsed);
+        if (validation.ok) {
+            return validation.value;
+        }
+        lastErrors = validation.errors;
+        if (attempt === maxRetries) {
+            break;
+        }
+        attemptPrompt = buildRetryPrompt(basePrompt, lastErrors);
+    }
+    throw new StructuredAgentResponseError("Agent response did not match the required JSON schema", {
+        lastResponse,
+        validationErrors: lastErrors,
+    });
+}
+export async function generateStructuredAgentResponse(options) {
+    const { manager, agentConfig, agentId, prompt, schema, maxRetries, schemaName } = options;
+    const modeId = agentConfig.modeId ??
+        getAgentProviderDefinition(agentConfig.provider).defaultModeId ??
+        undefined;
+    const agent = await manager.createAgent({ ...agentConfig, modeId }, agentId);
+    try {
+        const caller = async (nextPrompt) => {
+            const result = await manager.runAgent(agent.id, nextPrompt);
+            if (typeof result.finalText === "string" && result.finalText.length > 0) {
+                return result.finalText;
+            }
+            // Fallback for providers that may not populate finalText consistently.
+            const lastAssistant = result.timeline
+                .filter((item) => item.type === "assistant_message")
+                .at(-1);
+            return lastAssistant?.text ?? "";
+        };
+        return await getStructuredAgentResponse({
+            caller,
+            prompt,
+            schema,
+            maxRetries,
+            schemaName,
+        });
+    }
+    finally {
+        try {
+            await manager.closeAgent(agent.id);
+        }
+        catch {
+            // ignore cleanup errors
+        }
+    }
+}
+function errorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+export async function generateStructuredAgentResponseWithFallback(options) {
+    const { manager, cwd, prompt, schema, providers, agentConfigOverrides, maxRetries, schemaName, runner, } = options;
+    if (providers.length === 0) {
+        throw new StructuredAgentFallbackError([]);
+    }
+    const runStructured = runner ??
+        ((input) => generateStructuredAgentResponse(input));
+    const availability = await manager.listProviderAvailability();
+    const availabilityByProvider = new Map(availability.map((entry) => [entry.provider, entry]));
+    const attempts = [];
+    for (const candidate of providers) {
+        const availabilityEntry = availabilityByProvider.get(candidate.provider);
+        if (availabilityEntry && !availabilityEntry.available) {
+            attempts.push({
+                provider: candidate.provider,
+                model: candidate.model ?? null,
+                available: false,
+                error: availabilityEntry.error ?? null,
+            });
+            continue;
+        }
+        try {
+            const result = await runStructured({
+                manager,
+                prompt,
+                schema,
+                maxRetries,
+                schemaName,
+                agentConfig: {
+                    ...agentConfigOverrides,
+                    provider: candidate.provider,
+                    cwd,
+                    ...(candidate.model ? { model: candidate.model } : {}),
+                    ...(candidate.thinkingOptionId ? { thinkingOptionId: candidate.thinkingOptionId } : {}),
+                },
+            });
+            return result;
+        }
+        catch (error) {
+            attempts.push({
+                provider: candidate.provider,
+                model: candidate.model ?? null,
+                available: true,
+                error: errorMessage(error),
+            });
+        }
+    }
+    throw new StructuredAgentFallbackError(attempts);
+}
+//# sourceMappingURL=agent-response-loop.js.map