@cogitator-ai/studio 0.1.0

package/dist/protocol.d.ts

@@ -0,0 +1,398 @@
+/**
+ * What the studio's three parts say to each other: the runtime host (a child
+ * process that runs the project), the server, and the UI in the browser. The
+ * file has no imports, so the UI bundle can share it.
+ */
+export interface ToolInfo {
+    name: string;
+    description: string;
+    /** JSON Schema of the arguments. */
+    parameters: unknown;
+    requiresApproval: boolean;
+}
+export interface AgentInfo {
+    /** The key the registry exports it under. */
+    key: string;
+    name: string;
+    description?: string;
+    /** `provider/model`, absent when the agent takes the runtime's default model. */
+    model?: string;
+    instructions: string;
+    tools: ToolInfo[];
+}
+export interface WorkflowEdgeInfo {
+    type: string;
+    from: string;
+    to: string[];
+}
+export interface WorkflowInfo {
+    key: string;
+    name: string;
+    entryPoint: string;
+    nodes: string[];
+    edges: WorkflowEdgeInfo[];
+    /** The state the workflow starts from, as JSON, the default input of a run. */
+    initialState: unknown;
+}
+export interface SwarmInfo {
+    key: string;
+    name: string;
+    strategy: string;
+    agents: string[];
+}
+export interface RegistryInfo {
+    /** The runtime's `llm.defaultModel`, which agents without a model of their own run on. */
+    defaultModel?: string;
+    agents: AgentInfo[];
+    workflows: WorkflowInfo[];
+    swarms: SwarmInfo[];
+}
+export interface UsageInfo {
+    inputTokens: number;
+    outputTokens: number;
+    /** USD, as the provider reported it or priced from the model registry. */
+    cost: number;
+    /** Whether `cost` is known: false when no model of the run has a price. */
+    priced?: boolean;
+    duration: number;
+}
+/** A span of a run as the trace shows it, with its own cost when it is a model call. */
+export interface SpanRecord {
+    id: string;
+    parentId?: string;
+    name: string;
+    kind: 'llm' | 'tool' | 'agent' | 'handoff' | 'other';
+    status: 'ok' | 'error' | 'unset';
+    startTime: number;
+    endTime: number;
+    duration: number;
+    model?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    /** USD of a model call, `undefined` when the model's price is unknown. */
+    cost?: number;
+    attributes: Record<string, unknown>;
+}
+export interface ToolCallRecord {
+    id: string;
+    name: string;
+    arguments: unknown;
+    result?: unknown;
+    error?: string;
+    approval?: {
+        id: string;
+        status: 'waiting' | 'approved' | 'rejected';
+        reason?: string;
+    };
+}
+export type RunStatus = 'running' | 'waiting' | 'completed' | 'failed' | 'stopped';
+export interface WorkflowNodeRecord {
+    name: string;
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'skipped';
+    startedAt?: number;
+    duration?: number;
+    output?: unknown;
+    error?: string;
+}
+/** A run the studio keeps: an agent run, a workflow run, or a fork of an agent run. */
+export interface RunRecord {
+    id: string;
+    kind: 'agent' | 'workflow' | 'fork';
+    /** Registry key of the agent or workflow. */
+    target: string;
+    /** The agent's own name, which nested runs are found by. */
+    agentName?: string;
+    threadId?: string;
+    input: string;
+    output?: string;
+    reasoning?: string;
+    status: RunStatus;
+    error?: string;
+    startedAt: number;
+    endedAt?: number;
+    model?: string;
+    toolCalls: ToolCallRecord[];
+    spans: SpanRecord[];
+    usage?: UsageInfo;
+    /** Runs of agents this run's tools started, in the order they started. */
+    children: string[];
+    parentRunId?: string;
+    /** The tool call of the parent run that started this run. */
+    parentToolCallId?: string;
+    /** Tool-call steps a fork can start from: 0 is before the first tool call. */
+    steps?: StepRecord[];
+    forkOf?: ForkOrigin;
+    /** Runs forked from this one. */
+    forks: string[];
+    nodes?: WorkflowNodeRecord[];
+    /** The workflow manager's id of the run, which a rerun starts from. */
+    workflowRunId?: string;
+    rerunOf?: {
+        runId: string;
+        fromNode: string;
+    };
+}
+export interface StepRecord {
+    index: number;
+    checkpointId: string;
+    label: string;
+    /** Tool calls made before this step. */
+    toolCalls: Array<{
+        name: string;
+        result: unknown;
+    }>;
+}
+export interface ForkOrigin {
+    runId: string;
+    step: number;
+    input?: string;
+    context?: string;
+    toolResults?: Record<string, unknown>;
+}
+/** An agent or workflow with what its runs did, for the overview. */
+export interface TargetStats {
+    target: string;
+    kind: 'agent' | 'workflow';
+    /** Every run of it, the ones agent tools started included. */
+    runs: number;
+    failed: number;
+    cost: number;
+    priced: boolean;
+    lastRunAt: number;
+}
+/** Aggregates over every run the studio keeps. */
+export interface StudioStats {
+    /** Runs started from the studio, nested ones not counted. */
+    runs: number;
+    byStatus: Record<RunStatus, number>;
+    /** USD of every run, nested ones included. */
+    cost: number;
+    /** Whether any run had a known price. */
+    priced: boolean;
+    inputTokens: number;
+    outputTokens: number;
+    /** Wall time in ms of the finished runs started from the studio, `null` before the first. */
+    duration: {
+        p50: number;
+        p95: number;
+    } | null;
+    /** Runs started from the studio per local day, oldest first, today last. */
+    activity: Array<{
+        day: number;
+        runs: number;
+        failed: number;
+    }>;
+    /** Busiest first. */
+    targets: TargetStats[];
+}
+/** A conversation with an agent across runs. */
+export interface ThreadRecord {
+    id: string;
+    agent: string;
+    title: string;
+    createdAt: number;
+    updatedAt: number;
+    runs: string[];
+}
+export interface ForkRequest {
+    step: number;
+    input?: string;
+    context?: string;
+    toolResults?: Record<string, unknown>;
+}
+/** What the host reports while it runs things. */
+export type HostEvent = {
+    type: 'run.started';
+    runId: string;
+    kind: RunRecord['kind'];
+    target: string;
+    agentName?: string;
+    input: string;
+    threadId?: string;
+    model?: string;
+    rootRunId: string;
+    startedAt: number;
+    forkOf?: ForkOrigin;
+    rerunOf?: {
+        runId: string;
+        fromNode: string;
+    };
+} | {
+    type: 'run.token';
+    runId: string;
+    text: string;
+} | {
+    type: 'run.reasoning';
+    runId: string;
+    text: string;
+} | {
+    type: 'run.tool.call';
+    runId: string;
+    call: {
+        id: string;
+        name: string;
+        arguments: unknown;
+    };
+} | {
+    type: 'run.tool.result';
+    runId: string;
+    callId: string;
+    result: unknown;
+    error?: string;
+} | {
+    type: 'run.approval';
+    runId: string;
+    approvalId: string;
+    callId: string;
+    toolName: string;
+    arguments: unknown;
+    description: string;
+} | {
+    type: 'run.approval.decided';
+    runId: string;
+    approvalId: string;
+    approved: boolean;
+    reason?: string;
+} | {
+    type: 'run.span';
+    runId: string;
+    span: RawSpan;
+} | {
+    type: 'run.completed';
+    runId: string;
+    output: string;
+    usage: UsageInfo;
+    endedAt: number;
+    /** Every tool call of the run with its result, also those no callback reported. */
+    toolCalls?: Array<{
+        id: string;
+        name: string;
+        arguments: unknown;
+        result?: unknown;
+        error?: string;
+    }>;
+    steps?: StepRecord[];
+    workflowRunId?: string;
+} | {
+    type: 'run.failed';
+    runId: string;
+    error: string;
+    endedAt: number;
+    stopped: boolean;
+} | {
+    type: 'workflow.node';
+    runId: string;
+    node: string;
+    status: WorkflowNodeRecord['status'];
+    at: number;
+    duration?: number;
+    output?: unknown;
+    error?: string;
+};
+/** A span as the runtime reports it. */
+export interface RawSpan {
+    id: string;
+    traceId: string;
+    parentId?: string;
+    name: string;
+    status: 'ok' | 'error' | 'unset';
+    startTime: number;
+    endTime: number;
+    duration: number;
+    attributes: Record<string, unknown>;
+}
+/** What the server pushes to the UI over server-sent events. */
+export type StudioEvent = {
+    type: 'host';
+    status: HostStatus;
+} | {
+    type: 'run';
+    run: RunRecord;
+} | {
+    type: 'token';
+    runId: string;
+    text: string;
+} | {
+    type: 'reasoning';
+    runId: string;
+    text: string;
+} | {
+    type: 'thread';
+    thread: ThreadRecord;
+};
+export type HostStatus = {
+    state: 'starting';
+} | {
+    state: 'ready';
+    registry: RegistryInfo;
+    memory: 'project' | 'studio';
+    loadedAt: number;
+} | {
+    state: 'failed';
+    error: string;
+} | {
+    state: 'restarting';
+    reason: string;
+};
+/** Requests the server sends the host. */
+export type HostRequest = {
+    type: 'chat';
+    requestId: string;
+    agent: string;
+    input: string;
+    threadId: string;
+    history: HistoryMessage[];
+} | {
+    type: 'stop';
+    requestId: string;
+    runId: string;
+} | {
+    type: 'approve';
+    requestId: string;
+    approvalId: string;
+    approved: boolean;
+    reason?: string;
+} | {
+    type: 'fork';
+    requestId: string;
+    run: RunRecord;
+    fork: ForkRequest;
+} | {
+    type: 'workflow.run';
+    requestId: string;
+    workflow: string;
+    input: unknown;
+} | {
+    type: 'workflow.rerun';
+    requestId: string;
+    run: RunRecord;
+    fromNode: string;
+};
+/** A message of a thread, replayed into a fresh memory when the host restarts. */
+export interface HistoryMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+/** Messages from the host to the server. */
+export type HostMessage = {
+    type: 'ready';
+    registry: RegistryInfo;
+    memory: 'project' | 'studio';
+} | {
+    type: 'load-failed';
+    error: string;
+} | {
+    type: 'event';
+    event: HostEvent;
+} | {
+    type: 'response';
+    requestId: string;
+    ok: true;
+    data: unknown;
+} | {
+    type: 'response';
+    requestId: string;
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

package/dist/protocol.js

@@ -0,0 +1,7 @@
+/**
+ * What the studio's three parts say to each other: the runtime host (a child
+ * process that runs the project), the server, and the UI in the browser. The
+ * file has no imports, so the UI bundle can share it.
+ */
+export {};
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/registry.d.ts

@@ -0,0 +1,8 @@
+import type { RegistryInfo } from './protocol.js';
+/** Where a scaffolded project registers its agents, workflows and swarms. */
+export declare const REGISTRY_PATH = "src/cogitator.ts";
+type UnknownRecord = Record<string, unknown>;
+/** The agents, workflows and swarms a registry module exports, as plain data. */
+export declare function describeRegistry(module: UnknownRecord): RegistryInfo;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,YAAY,EAAqC,MAAM,eAAe,CAAC;AAEhG,6EAA6E;AAC7E,eAAO,MAAM,aAAa,qBAAqB,CAAC;AAWhD,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAuG7C,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,CAQpE"}

package/dist/registry.js

@@ -0,0 +1,119 @@
+/** Where a scaffolded project registers its agents, workflows and swarms. */
+export const REGISTRY_PATH = 'src/cogitator.ts';
+/** `value` as plain JSON, `null` for what JSON cannot hold. */
+function jsonSafe(value) {
+    try {
+        return JSON.parse(JSON.stringify(value ?? null));
+    }
+    catch {
+        return null;
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function stringOf(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+/**
+ * The agent behind a value, judged by shape: the project and the CLI may load
+ * different copies of @cogitator-ai/core, so `instanceof Agent` cannot be used.
+ */
+function agentShape(value) {
+    if (!isRecord(value) || !isRecord(value.config))
+        return undefined;
+    if (typeof value.config.name !== 'string' || typeof value.config.instructions !== 'string') {
+        return undefined;
+    }
+    return { config: value.config, tools: Array.isArray(value.tools) ? value.tools : [] };
+}
+function describeTool(value) {
+    if (!isRecord(value) || typeof value.name !== 'string')
+        return undefined;
+    const schema = typeof value.toJSON === 'function' ? value.toJSON() : undefined;
+    return {
+        name: value.name,
+        description: stringOf(value.description) ?? '',
+        parameters: isRecord(schema) ? schema.parameters : undefined,
+        requiresApproval: value.requiresApproval !== undefined && value.requiresApproval !== false,
+    };
+}
+function describeAgent(key, value) {
+    const agent = agentShape(value);
+    if (!agent)
+        return undefined;
+    const { config } = agent;
+    return {
+        key,
+        name: String(config.name),
+        ...(stringOf(config.description) && { description: stringOf(config.description) }),
+        ...(stringOf(config.model) && { model: stringOf(config.model) }),
+        instructions: String(config.instructions),
+        tools: agent.tools.map(describeTool).filter((tool) => tool !== undefined),
+    };
+}
+function describeWorkflow(key, value) {
+    if (!isRecord(value) || !(value.nodes instanceof Map) || typeof value.entryPoint !== 'string') {
+        return undefined;
+    }
+    const edges = Array.isArray(value.edges) ? value.edges.filter(isRecord) : [];
+    return {
+        key,
+        name: stringOf(value.name) ?? key,
+        entryPoint: value.entryPoint,
+        initialState: jsonSafe(value.initialState),
+        nodes: [...value.nodes.keys()].map(String),
+        edges: edges.map((edge) => {
+            const targets = [edge.to, edge.targets, edge.back, edge.exit].flatMap((target) => Array.isArray(target) ? target.map(String) : typeof target === 'string' ? [target] : []);
+            return { type: stringOf(edge.type) ?? 'sequential', from: String(edge.from), to: targets };
+        }),
+    };
+}
+function describeSwarm(key, value) {
+    if (!isRecord(value) || typeof value.strategy !== 'string')
+        return undefined;
+    const names = new Set();
+    const add = (candidate) => {
+        const agent = agentShape(candidate);
+        if (agent)
+            names.add(String(agent.config.name));
+    };
+    for (const field of ['supervisor', 'moderator', 'router'])
+        add(value[field]);
+    for (const field of ['workers', 'agents']) {
+        const list = value[field];
+        if (Array.isArray(list))
+            list.forEach(add);
+    }
+    if (Array.isArray(value.stages)) {
+        for (const stage of value.stages)
+            if (isRecord(stage))
+                add(stage.agent);
+    }
+    return { key, name: stringOf(value.name) ?? key, strategy: value.strategy, agents: [...names] };
+}
+function describeGroup(group, describe) {
+    if (!isRecord(group))
+        return [];
+    return Object.entries(group)
+        .map(([key, value]) => describe(key, value))
+        .filter((item) => item !== undefined);
+}
+/** `llm.defaultModel` of the runtime the registry exports as `cogitator`. */
+function defaultModelOf(runtime) {
+    if (!isRecord(runtime) || !isRecord(runtime.config) || !isRecord(runtime.config.llm)) {
+        return undefined;
+    }
+    return stringOf(runtime.config.llm.defaultModel);
+}
+/** The agents, workflows and swarms a registry module exports, as plain data. */
+export function describeRegistry(module) {
+    const defaultModel = defaultModelOf(module.cogitator);
+    return {
+        ...(defaultModel && { defaultModel }),
+        agents: describeGroup(module.agents, describeAgent),
+        workflows: describeGroup(module.workflows, describeWorkflow),
+        swarms: describeGroup(module.swarms, describeSwarm),
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/server/host-manager.d.ts

@@ -0,0 +1,52 @@
+import type { HostEvent, HostRequest, HostStatus } from '../protocol.js';
+/** Distributes `Omit` over a union, so each request keeps its own fields. */
+type WithoutId<T> = T extends unknown ? Omit<T, 'requestId'> : never;
+export interface HostManagerOptions {
+    projectDir: string;
+    studioDir: string;
+    /** Restart the host when the project changes (default `true`). */
+    watch?: boolean;
+    onStatus: (status: HostStatus) => void;
+    onEvent: (event: HostEvent) => void;
+    /** Runs still going when the host goes away. */
+    onLost: (reason: string) => void;
+    /** Output of the project's own code. */
+    onOutput?: (line: string, stream: 'stdout' | 'stderr') => void;
+    /** How long the project may take to load (default 60 s). */
+    loadTimeoutMs?: number;
+}
+/** Whether a change of `path` (relative to the project) should reload it. */
+export declare function reloadsProject(path: string): boolean;
+/**
+ * Keeps the runtime host running for the studio: starts it, sends it
+ * requests, and starts it again when the project changes, so the studio
+ * process and the browser stay while the code reloads.
+ */
+export declare class HostManager {
+    private readonly options;
+    private child?;
+    private status;
+    private readonly pending;
+    private readonly waiters;
+    private watcher?;
+    private debounce?;
+    private closed;
+    private generation;
+    constructor(options: HostManagerOptions);
+    get current(): HostStatus;
+    start(): void;
+    private setStatus;
+    private spawn;
+    private failPending;
+    private stopChild;
+    /** Starts the host again, with the project as it is now. */
+    restart(reason: string): Promise<void>;
+    private watchProject;
+    /** Resolves once the project is loaded; rejects when it failed to load. */
+    ready(timeoutMs?: number): Promise<void>;
+    /** Sends a request to the host once the project is loaded. */
+    request<T>(request: WithoutId<HostRequest>): Promise<T>;
+    close(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=host-manager.d.ts.map

package/dist/server/host-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-manager.d.ts","sourceRoot":"","sources":["../../src/server/host-manager.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAe,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEtF,6EAA6E;AAC7E,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,GAAG,IAAI,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC;AAErE,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IACvC,OAAO,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACpC,gDAAgD;IAChD,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;IAC/D,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAeD,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKpD;AA2BD;;;;GAIG;AACH,qBAAa,WAAW;IAUV,OAAO,CAAC,QAAQ,CAAC,OAAO;IATpC,OAAO,CAAC,KAAK,CAAC,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsE;IAC9F,OAAO,CAAC,OAAO,CAAC,CAAY;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAgC;IACjD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAK;gBAEM,OAAO,EAAE,kBAAkB;IAExD,IAAI,OAAO,IAAI,UAAU,CAExB;IAED,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,KAAK;IAmFb,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,SAAS;IAcjB,4DAA4D;IACtD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5C,OAAO,CAAC,YAAY;IAoBpB,2EAA2E;IAC3E,KAAK,CAAC,SAAS,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBxC,8DAA8D;IACxD,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAevD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}