@sift-wiki/conductor 0.0.0 → 0.2.0-beta.1

package/README.md

@@ -1,3 +1,107 @@
 # Sift Conductor
 
-Bootstrap package used to configure trusted publishing. Install the latest stable release after `0.1.0` is published.
+Sift Conductor is the optional local execution plane for Sift. One npm command
+opens a local browser app for connecting Codex CLI or Claude Code, managing
+shared work, and observing agent progress and results. Sift remains the
+canonical source of project, task, run, artifact, and approval state.
+
+Provider credentials and working-directory paths stay on the local machine.
+
+## Requirements
+
+- Node.js 20 or newer.
+- A Sift workspace and a short-lived computer pairing code.
+- Codex CLI `0.100.0` or newer and/or Claude Code `2.1.0` or newer.
+- The selected provider already installed or installed through its official
+  setup flow.
+
+## Start The Local App
+
+Run the exact version you want to use:
+
+```bash
+npx @sift-wiki/conductor@latest start
+```
+
+Conductor opens a loopback-only browser app. Enter the pairing code from Sift,
+add an agent from **Agents**, and start the local runtime. Closing the browser
+does not stop active work; keep the terminal process open and press `Ctrl+C` to
+stop Conductor.
+
+See the [complete quickstart](docs/quickstart.md),
+[provider setup](docs/provider-setup.md), and
+[troubleshooting guide](docs/troubleshooting.md).
+
+## Headless CLI
+
+Persistent headless installation:
+
+```bash
+npm install --global @sift-wiki/conductor
+sift-conductor --help
+```
+
+Pair and run without the browser interface:
+
+```bash
+sift-conductor pair --api https://api.sift.wiki --code SC-... --display-name "My computer"
+sift-conductor run --adapters ./agents.json
+```
+
+Example provider configuration:
+
+```json
+{
+  "adapters": [
+    {
+      "type": "codex",
+      "localKey": "product-codex",
+      "displayName": "Product engineer",
+      "workspacePath": "/absolute/path/to/project",
+      "accessProfile": "workspace",
+      "enabled": true
+    },
+    {
+      "type": "claude-code",
+      "localKey": "review-claude",
+      "displayName": "Code reviewer",
+      "workspacePath": "/absolute/path/to/project",
+      "accessProfile": "inspect",
+      "enabled": true
+    }
+  ]
+}
+```
+
+Use a stable `localKey`. Do not place API keys, OAuth tokens, or the Sift
+Conductor credential in this file.
+
+## Runtime Contract
+
+For each claimed job Conductor:
+
+1. checks out task-linked work and opens a run-scoped local bridge;
+2. renders the Sift wake envelope into a bounded provider prompt;
+3. invokes the provider noninteractively in the selected workspace;
+4. normalizes allowlisted provider actions into concise progress events;
+5. validates one structured `done`, `in_review`, or `blocked` result;
+6. settles the Sift task/run/job and closes the run-scoped bridge.
+
+The generic fake, process, and HTTP adapters remain available. Codex and Claude
+Code do not require a user-authored shell wrapper.
+
+## Security
+
+- Conductor never stores Codex or Claude Code credentials.
+- The long-lived Sift machine credential is never passed to an agent process.
+- Provider processes receive only an expiring run-scoped bridge token.
+- Local workspace paths are not advertised to Sift or exposed to browser code.
+- Raw prompts, hidden reasoning, full provider streams, and environment dumps
+  are not sent to Sift.
+- The initial desktop wizard does not offer dangerous bypass/full-machine
+  permission modes.
+
+## License
+
+Apache-2.0. Paperclip-derived behavioral references and notices are recorded in
+[`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md).

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,38 @@
+# Third-Party Notices
+
+## Paperclip
+
+Parts of the Sift Conductor provider adapter design and parsing behavior were
+adapted from Paperclip adapter utilities and its Codex Local and Claude Local
+adapters.
+
+- Project: https://github.com/paperclipai/paperclip
+- Reference revision: `d166069bc4da847357b2a5b82241048fd4563b83`
+- Copyright: Copyright (c) 2025 Paperclip AI
+- License: MIT
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+The Sift/Paperclip visual prototype was used as an interface reference rather
+than copied as a backend or bundled dependency:
+
+- Project: https://github.com/Sift-wiki/paperclip-sift-visual-prototype
+- Reference revision: `70788a1faf0909c490eb0c4ea928f8cb623f5ce0`

package/dist/adapters/claudeAgent.d.ts

@@ -0,0 +1,23 @@
+import type { AdapterReadiness, LocalAgentAdapter } from "./types.js";
+import { type ProviderProbeDeps } from "./provider/discovery.js";
+import type { ProviderAgentConfig } from "./provider/types.js";
+export declare const MINIMUM_CLAUDE_CODE_VERSION = "2.1.0";
+export type ClaudeAgentConfig = ProviderAgentConfig & {
+    type: "claude-code";
+};
+export type ClaudeAgentDeps = ProviderProbeDeps;
+export declare function createClaudeAgentAdapter(config: ClaudeAgentConfig, deps?: ClaudeAgentDeps): LocalAgentAdapter;
+export declare function checkClaudeAgent(config: ClaudeAgentConfig, deps?: ClaudeAgentDeps): Promise<AdapterReadiness>;
+export declare function buildClaudeInvocation(input: {
+    config: ClaudeAgentConfig;
+    executablePath: string;
+    prompt: string;
+    env?: Record<string, string> | undefined;
+    remainingCostMicros?: number | undefined;
+}): {
+    command: string;
+    args: string[];
+    cwd: string;
+    env: Record<string, string>;
+    stdin: string;
+};

package/dist/adapters/claudeAgent.js

@@ -0,0 +1,164 @@
+import { createClaudeStreamParser } from "./claudeParser.js";
+import { probeCommand, resolveProviderExecutable, safeExecutableLabel, validateWorkspace, } from "./provider/discovery.js";
+import { composeProviderPrompt } from "./provider/prompt.js";
+import { providerTerminalJsonSchema } from "./provider/result.js";
+import { runProviderAdapter } from "./provider/runProvider.js";
+import { extractVersion, versionAtLeast } from "./provider/version.js";
+export const MINIMUM_CLAUDE_CODE_VERSION = "2.1.0";
+export function createClaudeAgentAdapter(config, deps = {}) {
+    return {
+        localKey: config.localKey,
+        displayName: config.displayName,
+        adapterType: "claude-code",
+        enabled: config.enabled,
+        capabilities: {
+            provider: "anthropic",
+            streaming: true,
+            structuredOutput: true,
+            cancellation: "process-tree",
+            accessProfile: config.accessProfile,
+        },
+        check: () => checkClaudeAgent(config, deps),
+        run: (input) => runClaudeAgent(input, config, deps),
+    };
+}
+export async function checkClaudeAgent(config, deps = {}) {
+    if (!config.enabled) {
+        return {
+            status: "error",
+            message: "Claude Code agent is paused.",
+            hint: "Resume it before assigning work.",
+            remediation: "resume",
+        };
+    }
+    const workspace = await validateWorkspace(config);
+    if (!workspace.ok) {
+        return { status: "error", message: workspace.message, remediation: "select-folder" };
+    }
+    const executablePath = await resolveProviderExecutable({
+        provider: "claude-code",
+        executablePath: config.executablePath,
+        cwd: config.workspacePath,
+        env: deps.env,
+    });
+    if (executablePath === undefined) {
+        return {
+            status: "error",
+            message: "Claude Code was not found.",
+            hint: "Install Claude Code or choose its executable in Sift Conductor.",
+            remediation: "install",
+        };
+    }
+    const versionProbe = await probeCommand({
+        command: executablePath,
+        args: ["--version"],
+        cwd: config.workspacePath,
+        deps,
+    });
+    const version = extractVersion(`${versionProbe.stdout}\n${versionProbe.stderr}`);
+    if (version === undefined || !versionAtLeast(version, MINIMUM_CLAUDE_CODE_VERSION)) {
+        return {
+            status: "error",
+            message: "Claude Code version is unsupported.",
+            hint: `Upgrade Claude Code to ${MINIMUM_CLAUDE_CODE_VERSION} or newer.`,
+            remediation: "upgrade",
+        };
+    }
+    const authProbe = await probeCommand({
+        command: executablePath,
+        args: ["auth", "status", "--json"],
+        cwd: config.workspacePath,
+        deps,
+    });
+    if (!claudeAuthReady(authProbe.stdout, authProbe.exitCode)) {
+        return {
+            status: "error",
+            message: "Claude Code authentication is required.",
+            hint: "Sign in through the Claude Code login flow, then retest this agent.",
+            remediation: "login",
+        };
+    }
+    return {
+        status: "ready",
+        message: `${safeExecutableLabel(executablePath)} ${version} is ready.`,
+        metadata: { providerVersion: version, accessProfile: config.accessProfile },
+    };
+}
+export function buildClaudeInvocation(input) {
+    const args = [
+        "--print",
+        "--input-format",
+        "text",
+        "--output-format",
+        "stream-json",
+        "--verbose",
+        "--no-session-persistence",
+        "--json-schema",
+        JSON.stringify(providerTerminalJsonSchema),
+    ];
+    if (input.config.accessProfile === "inspect") {
+        args.push("--permission-mode", "plan", "--tools", "Read,Glob,Grep");
+    }
+    else {
+        args.push("--permission-mode", "acceptEdits", "--tools", "Read,Glob,Grep,Edit,Write", "--disallowedTools", "Bash,WebFetch,WebSearch");
+    }
+    if (input.config.model !== undefined)
+        args.push("--model", input.config.model);
+    if (input.remainingCostMicros !== undefined && input.remainingCostMicros > 0) {
+        args.push("--max-budget-usd", String(input.remainingCostMicros / 1_000_000));
+    }
+    return {
+        command: input.executablePath,
+        args,
+        cwd: input.config.workspacePath,
+        env: input.env ?? {},
+        stdin: input.prompt,
+    };
+}
+async function runClaudeAgent(input, config, deps) {
+    return runProviderAdapter({
+        provider: "claude-code",
+        runInput: input,
+        timeoutMs: config.timeoutMs,
+        graceMs: config.graceMs,
+        outputLimitBytes: config.outputLimitBytes,
+        ...(deps.runProcess === undefined ? {} : { runProcess: deps.runProcess }),
+        prepare: async () => buildClaudeInvocation({
+            config,
+            executablePath: await requiredExecutable(config, deps),
+            prompt: composeProviderPrompt(input),
+            env: input.env,
+            remainingCostMicros: input.wakeEnvelope?.limits.remainingCostMicros,
+        }),
+        createParser: () => createClaudeStreamParser({
+            emit: (event) => input.emit(event),
+            outputLimitBytes: config.outputLimitBytes,
+        }),
+    });
+}
+function claudeAuthReady(stdout, exitCode) {
+    if ((exitCode ?? 1) !== 0)
+        return false;
+    try {
+        const parsed = JSON.parse(stdout);
+        return typeof parsed === "object"
+            && parsed !== null
+            && !Array.isArray(parsed)
+            && parsed.loggedIn === true;
+    }
+    catch {
+        return false;
+    }
+}
+async function requiredExecutable(config, deps) {
+    const resolved = await resolveProviderExecutable({
+        provider: "claude-code",
+        executablePath: config.executablePath,
+        cwd: config.workspacePath,
+        env: deps.env,
+    });
+    if (resolved === undefined)
+        throw new Error("Claude Code was not found.");
+    return resolved;
+}
+//# sourceMappingURL=claudeAgent.js.map

package/dist/adapters/claudeAgent.js.map

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

package/dist/adapters/claudeParser.d.ts

@@ -0,0 +1,5 @@
+import type { ParsedProviderOutput, ProviderParserInput } from "./provider/types.js";
+export declare function createClaudeStreamParser(input: ProviderParserInput): {
+    push: (stream: "stdout" | "stderr", chunk: string) => Promise<void>;
+    finish(): Promise<ParsedProviderOutput>;
+};

package/dist/adapters/claudeParser.js

@@ -0,0 +1,120 @@
+import { boundAndRedactText } from "./output.js";
+import { asRecord, numberValue, parseJsonRecord, stringValue } from "./provider/json.js";
+import { ProviderLineStream } from "./provider/lineStream.js";
+import { parseProviderTerminalResult } from "./provider/result.js";
+export function createClaudeStreamParser(input) {
+    let sessionId;
+    let model;
+    let terminalRaw;
+    let errorMessage;
+    let stderrDiagnostic;
+    let usage;
+    const lines = new ProviderLineStream(async (stream, rawLine) => {
+        const line = rawLine.trim();
+        if (line.length === 0)
+            return;
+        if (stream === "stderr") {
+            stderrDiagnostic ??= boundAndRedactText(line, 2_000).text;
+            return;
+        }
+        const event = parseJsonRecord(line);
+        if (event === undefined)
+            return;
+        const type = stringValue(event.type);
+        sessionId = stringValue(event.session_id) ?? sessionId;
+        if (type === "system" && stringValue(event.subtype) === "init") {
+            model = stringValue(event.model) ?? model;
+            return;
+        }
+        if (type === "assistant") {
+            const message = asRecord(event.message);
+            const content = Array.isArray(message?.content) ? message.content : [];
+            for (const blockValue of content) {
+                const block = asRecord(blockValue);
+                if (stringValue(block?.type) !== "tool_use")
+                    continue;
+                const toolName = stringValue(block?.name);
+                await input.emit({
+                    eventType: "progress",
+                    payload: { summary: claudeToolSummary(toolName) },
+                });
+            }
+            return;
+        }
+        if (type !== "result")
+            return;
+        const rawUsage = asRecord(event.usage);
+        const costUsd = numberValue(event.total_cost_usd);
+        usage = {
+            ...(numberValue(rawUsage?.input_tokens) === undefined
+                ? {}
+                : { inputTokens: numberValue(rawUsage?.input_tokens) }),
+            ...(numberValue(rawUsage?.cache_read_input_tokens) === undefined
+                ? {}
+                : { cachedInputTokens: numberValue(rawUsage?.cache_read_input_tokens) }),
+            ...(numberValue(rawUsage?.output_tokens) === undefined
+                ? {}
+                : { outputTokens: numberValue(rawUsage?.output_tokens) }),
+            ...(costUsd === undefined ? {} : { costMicros: Math.round(costUsd * 1_000_000) }),
+        };
+        if (event.is_error === true) {
+            errorMessage = boundAndRedactText(stringValue(event.result) ?? claudeErrors(event) ?? "Claude Code reported an error.", 2_000).text;
+            return;
+        }
+        terminalRaw = event.structured_output ?? event.result;
+    });
+    return {
+        push: (stream, chunk) => lines.push(stream, chunk),
+        async finish() {
+            await lines.finish();
+            let terminalResult;
+            if (terminalRaw !== undefined) {
+                try {
+                    terminalResult = parseProviderTerminalResult(terminalRaw);
+                }
+                catch (error) {
+                    errorMessage ??= error instanceof Error ? error.message : "Claude Code terminal result is invalid.";
+                }
+            }
+            if (terminalResult === undefined)
+                errorMessage ??= stderrDiagnostic;
+            return {
+                ...(terminalResult === undefined ? {} : { terminalResult }),
+                ...(usage === undefined ? {} : { usage }),
+                ...(sessionId === undefined ? {} : { sessionId }),
+                ...(model === undefined ? {} : { model }),
+                ...(errorMessage === undefined ? {} : { errorMessage }),
+            };
+        },
+    };
+}
+function claudeToolSummary(toolName) {
+    switch (toolName) {
+        case "Read":
+        case "Glob":
+        case "Grep":
+            return "Inspecting workspace context.";
+        case "Edit":
+        case "Write":
+        case "NotebookEdit":
+            return "Updating workspace files.";
+        case "Bash":
+            return "Running a local workspace command.";
+        default:
+            return "Using a local agent tool.";
+    }
+}
+function claudeErrors(event) {
+    if (!Array.isArray(event.errors))
+        return undefined;
+    for (const value of event.errors) {
+        if (typeof value === "string" && value.trim().length > 0)
+            return value;
+        const error = asRecord(value);
+        const message = stringValue(error?.message) ?? stringValue(error?.error);
+        if (message !== undefined)
+            return message;
+    }
+    return undefined;
+}
+//# sourceMappingURL=claudeParser.js.map

package/dist/adapters/claudeParser.js.map

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

package/dist/adapters/codexAgent.d.ts

@@ -0,0 +1,28 @@
+import type { AdapterReadiness, LocalAgentAdapter } from "./types.js";
+import { type ProviderProbeDeps } from "./provider/discovery.js";
+import { type PreparedOutputSchema } from "./provider/outputSchemaFile.js";
+import type { ProviderAgentConfig } from "./provider/types.js";
+import type { RunProcess } from "../runtime/process.js";
+export declare const MINIMUM_CODEX_VERSION = "0.100.0";
+export type CodexAgentConfig = ProviderAgentConfig & {
+    type: "codex";
+};
+export type CodexAgentDeps = ProviderProbeDeps & {
+    prepareOutputSchema?: (() => Promise<PreparedOutputSchema>) | undefined;
+};
+export declare function createCodexAgentAdapter(config: CodexAgentConfig, deps?: CodexAgentDeps): LocalAgentAdapter;
+export declare function checkCodexAgent(config: CodexAgentConfig, deps?: CodexAgentDeps): Promise<AdapterReadiness>;
+export declare function buildCodexInvocation(input: {
+    config: CodexAgentConfig;
+    executablePath: string;
+    schemaPath: string;
+    prompt: string;
+    env?: Record<string, string> | undefined;
+}): {
+    command: string;
+    args: string[];
+    cwd: string;
+    env: Record<string, string>;
+    stdin: string;
+};
+export type { RunProcess };

package/dist/adapters/codexAgent.js

@@ -0,0 +1,152 @@
+import { createCodexStreamParser } from "./codexParser.js";
+import { composeProviderPrompt } from "./provider/prompt.js";
+import { probeCommand, resolveProviderExecutable, safeExecutableLabel, validateWorkspace, } from "./provider/discovery.js";
+import { prepareProviderOutputSchema, } from "./provider/outputSchemaFile.js";
+import { runProviderAdapter } from "./provider/runProvider.js";
+import { extractVersion, versionAtLeast } from "./provider/version.js";
+export const MINIMUM_CODEX_VERSION = "0.100.0";
+export function createCodexAgentAdapter(config, deps = {}) {
+    return {
+        localKey: config.localKey,
+        displayName: config.displayName,
+        adapterType: "codex",
+        enabled: config.enabled,
+        capabilities: {
+            provider: "openai",
+            streaming: true,
+            structuredOutput: true,
+            cancellation: "process-tree",
+            accessProfile: config.accessProfile,
+        },
+        check: () => checkCodexAgent(config, deps),
+        run: (input) => runCodexAgent(input, config, deps),
+    };
+}
+export async function checkCodexAgent(config, deps = {}) {
+    if (!config.enabled) {
+        return {
+            status: "error",
+            message: "Codex agent is paused.",
+            hint: "Resume it before assigning work.",
+            remediation: "resume",
+        };
+    }
+    const workspace = await validateWorkspace(config);
+    if (!workspace.ok) {
+        return { status: "error", message: workspace.message, remediation: "select-folder" };
+    }
+    const executablePath = await resolveProviderExecutable({
+        provider: "codex",
+        executablePath: config.executablePath,
+        cwd: config.workspacePath,
+        env: deps.env,
+    });
+    if (executablePath === undefined) {
+        return {
+            status: "error",
+            message: "Codex CLI was not found.",
+            hint: "Install Codex CLI or choose its executable in Sift Conductor.",
+            remediation: "install",
+        };
+    }
+    const versionProbe = await probeCommand({
+        command: executablePath,
+        args: ["--version"],
+        cwd: config.workspacePath,
+        deps,
+    });
+    const version = extractVersion(`${versionProbe.stdout}\n${versionProbe.stderr}`);
+    if (version === undefined || !versionAtLeast(version, MINIMUM_CODEX_VERSION)) {
+        return {
+            status: "error",
+            message: "Codex CLI version is unsupported.",
+            hint: `Upgrade Codex CLI to ${MINIMUM_CODEX_VERSION} or newer.`,
+            remediation: "upgrade",
+        };
+    }
+    const authProbe = await probeCommand({
+        command: executablePath,
+        args: ["login", "status"],
+        cwd: config.workspacePath,
+        deps,
+    });
+    if ((authProbe.exitCode ?? 1) !== 0 || !/logged\s+in/iu.test(`${authProbe.stdout}\n${authProbe.stderr}`)) {
+        return {
+            status: "error",
+            message: "Codex CLI authentication is required.",
+            hint: "Sign in through the Codex login flow, then retest this agent.",
+            remediation: "login",
+        };
+    }
+    return {
+        status: "ready",
+        message: `${safeExecutableLabel(executablePath)} ${version} is ready.`,
+        metadata: { providerVersion: version, accessProfile: config.accessProfile },
+    };
+}
+export function buildCodexInvocation(input) {
+    const args = [
+        "exec",
+        "--json",
+        "--ephemeral",
+        "--skip-git-repo-check",
+        "--cd",
+        input.config.workspacePath,
+        "--sandbox",
+        input.config.accessProfile === "inspect" ? "read-only" : "workspace-write",
+        "--output-schema",
+        input.schemaPath,
+    ];
+    if (input.config.model !== undefined)
+        args.push("--model", input.config.model);
+    args.push("-");
+    return {
+        command: input.executablePath,
+        args,
+        cwd: input.config.workspacePath,
+        env: input.env ?? {},
+        stdin: input.prompt,
+    };
+}
+async function runCodexAgent(input, config, deps) {
+    let schema;
+    return runProviderAdapter({
+        provider: "codex",
+        runInput: input,
+        timeoutMs: config.timeoutMs,
+        graceMs: config.graceMs,
+        outputLimitBytes: config.outputLimitBytes,
+        ...(deps.runProcess === undefined ? {} : { runProcess: deps.runProcess }),
+        prepare: async () => {
+            const executablePath = await requiredExecutable(config, deps);
+            schema = await (deps.prepareOutputSchema ?? prepareProviderOutputSchema)();
+            const preparedSchema = schema;
+            return {
+                ...buildCodexInvocation({
+                    config,
+                    executablePath,
+                    schemaPath: schema.path,
+                    prompt: composeProviderPrompt(input),
+                    env: input.env,
+                }),
+                cleanup: () => preparedSchema.cleanup(),
+            };
+        },
+        createParser: () => createCodexStreamParser({
+            emit: (event) => input.emit(event),
+            outputLimitBytes: config.outputLimitBytes,
+        }),
+    });
+}
+async function requiredExecutable(config, deps) {
+    const resolved = await resolveProviderExecutable({
+        provider: "codex",
+        executablePath: config.executablePath,
+        cwd: config.workspacePath,
+        env: deps.env,
+    });
+    if (resolved === undefined)
+        throw new Error("Codex CLI was not found.");
+    return resolved;
+}
+//# sourceMappingURL=codexAgent.js.map