synorch 0.2.0 → 0.4.0-beta.0

package/dist/harness/cli/extensions/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../../src/harness/cli/extensions/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAwB,KAAK,cAAc,EAAoB,MAAM,aAAa,CAAC;AAC1F,OAAO,EAAqG,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AACpN,OAAO,EAAwE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAmB,MAAM,YAAY,CAAC;AAE7K;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,sFAAsF;IACtF,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,KAAK,IAAI,cAAc,CAAC;IACxB,QAAQ,IAAI,UAAU,EAAE,CAAC;IACzB,kGAAkG;IAClG,SAAS,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,aAAa,EAAE,CAAC;IAC1D,qCAAqC;IACrC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IAC9C,0FAA0F;IAC1F,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAChF,UAAU,IAAI,SAAS,mBAAmB,EAAE,CAAC;IAC7C,QAAQ,IAAI,SAAS,MAAM,EAAE,CAAC;IAC9B,QAAQ,IAAI,iBAAiB,CAAC;IAC9B,+FAA+F;IAC/F,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,6FAA6F;IAC7F,MAAM,CAAC,QAAQ,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,kBAAkB,EAAE,qBAAqB,GAAG,sBAAsB,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACjJ,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC;IACxC,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;CACzC;AAQD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAyDtF"}

package/dist/harness/cli/extensions/controller.js

@@ -0,0 +1,67 @@
+import { createPersonaCatalog } from "./agents.js";
+import { createMergedSkillCatalog, itemBody, loadExtensions, pluginDataDir, pluginMcpServers, resolveItems } from "./catalog.js";
+import { createHookEngine, hookSources, readHookApprovals } from "./hooks.js";
+function pluginAgents(state) {
+    return state.plugins
+        .filter((plugin) => plugin.enabled)
+        .flatMap((plugin) => plugin.contents.agentDefs.map((agent) => ({ ...agent, id: `${plugin.contents.name}:${agent.name}`, plugin: plugin.key, origin: plugin.origin })));
+}
+export async function createExtensions(options) {
+    let settings = options.settings;
+    const read = () => loadExtensions({
+        ...options,
+        includeClaudeSkills: settings.includeClaudeSkills,
+        includeClaudePlugins: settings.includeClaudePlugins,
+        disabledPlugins: settings.disabledPlugins,
+        trusted: options.trusted(),
+    });
+    let state = await read();
+    let approvals = await readHookApprovals(options.home);
+    const computeSources = () => hookSources({
+        user: settings.userHooks ?? {},
+        plugins: state.plugins
+            .filter((plugin) => plugin.enabled)
+            .map((plugin) => ({ key: plugin.key, origin: plugin.origin, root: plugin.contents.root, data: pluginDataDir(plugin, options), config: plugin.contents.hookConfig })),
+        approvals,
+    });
+    let sources = computeSources();
+    let agents = pluginAgents(state);
+    const disabled = () => new Set(settings.disabledSkills);
+    let mcp = pluginMcpServers(state, options);
+    const statuses = () => resolveItems(state.items, { trusted: options.trusted(), disabled: disabled() });
+    const active = () => statuses().filter((status) => status.state === "active").map((status) => status.item);
+    return {
+        env: options.env,
+        claudeHome: options.claudeHome,
+        skills: createMergedSkillCatalog({ canonical: options.canonicalCatalog, state: () => state, trusted: options.trusted, disabled, workspaceRoot: options.workspaceRoot }),
+        state: () => state,
+        statuses,
+        invocable: (reserved) => active().filter((entry) => entry.meta.userInvocable && !reserved.has(entry.name.toLowerCase())),
+        find: (name) => active().find((entry) => entry.name === name) ?? active().find((entry) => entry.name.toLowerCase() === name.toLowerCase()),
+        async invocationText(entry, args) {
+            const canonical = entry.canonical ? await options.canonicalCatalog.load(entry.name) : undefined;
+            const body = entry.canonical ? (canonical === undefined ? undefined : args.trim() === "" ? canonical : `${canonical}\n\nARGUMENTS: ${args.trim()}`) : await itemBody(entry, args, options.workspaceRoot);
+            if (body === undefined)
+                return undefined;
+            const label = entry.kind === "skill" ? "Skill" : "Command";
+            const shown = `${label} /${entry.name}${args.trim() === "" ? "" : ` ${args.trim()}`}`;
+            const tools = entry.meta.allowedTools.length === 0 ? "" : `\n(The ${entry.kind} lists allowed-tools ${entry.meta.allowedTools.join(" ")}; Synorch's permission mode still decides.)`;
+            return `${shown}\n<synorch-attachments>\nThe user invoked the ${entry.kind} /${entry.name} (${entry.source}: ${entry.location}). Follow these instructions for this request:${tools}\n\n${body}\n</synorch-attachments>`;
+        },
+        mcpServers: () => mcp.servers,
+        problems: () => [...state.problems, ...mcp.problems],
+        settings: () => settings,
+        hooks: createHookEngine({ env: options.env, sources: () => sources, ...(options.hookRunner === undefined ? {} : { run: options.hookRunner }) }),
+        personas: createPersonaCatalog(() => agents),
+        async reload(next) {
+            if (next !== undefined)
+                settings = next;
+            state = await read();
+            approvals = await readHookApprovals(options.home);
+            sources = computeSources();
+            agents = pluginAgents(state);
+            mcp = pluginMcpServers(state, options);
+        },
+    };
+}
+//# sourceMappingURL=controller.js.map

package/dist/harness/cli/extensions/controller.js.map

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

package/dist/harness/cli/extensions/hooks.d.ts

@@ -0,0 +1,164 @@
+/**
+ * K7 hooks in Claude Code's format (code.claude.com/docs/en/hooks, checked 2026-09-25): a plugin's
+ * `hooks/hooks.json` (or manifest `hooks`) and the user configuration's `hooks:` block, both
+ * `{ <Event>: [{ matcher?, hooks: [{ type: "command", command, args?, timeout? }] }] }`.
+ *
+ * Supported events (the ones that map onto Synorch's tool gateway and conversation loop):
+ * SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop. Other events and non-`command`
+ * hook types are listed as unsupported and never run.
+ *
+ * A command hook gets the event as JSON on stdin and answers with its exit code and stdout:
+ *   exit 0   stdout JSON is read (`continue: false`, `decision: "block"`, `reason`,
+ *            `systemMessage`, `hookSpecificOutput.{permissionDecision, permissionDecisionReason,
+ *            additionalContext}`); plain stdout is context for SessionStart / UserPromptSubmit
+ *   exit 2   blocks (PreToolUse denies, UserPromptSubmit drops the prompt, Stop continues the
+ *            turn); stderr is the reason (PostToolUse: fed back to the model)
+ *   other    a non-blocking error, shown as a note
+ *
+ * Safety: hooks run arbitrary commands. User hooks (`hooks:` in `~/.synorch/config.yaml`) are the
+ * user's own and run as written. A plugin's hooks run only after the user approved them; the
+ * approval stores a digest of the hook definitions and the plugin root, so a changed plugin asks
+ * again. Claude-sourced plugin hooks are off until `/plugins hooks approve <plugin>`, and never
+ * run on Claude Code native routes (Claude runs them itself there). A hook can deny or narrow a
+ * tool call (allow → ask), never widen one: `permissionDecision: "allow"` and `updatedInput` are
+ * ignored and the policy engine's hard rails always apply.
+ */
+export declare const HOOK_EVENTS: readonly ["SessionStart", "UserPromptSubmit", "PreToolUse", "PostToolUse", "Stop"];
+export type HookEvent = (typeof HOOK_EVENTS)[number];
+export interface HookCommand {
+    readonly command: string;
+    readonly args: readonly string[] | undefined;
+    /** Seconds. */
+    readonly timeout: number | undefined;
+}
+export interface HookGroup {
+    readonly matcher: string | undefined;
+    readonly hooks: readonly HookCommand[];
+}
+export type HookConfig = Readonly<Partial<Record<HookEvent, readonly HookGroup[]>>>;
+export interface ParsedHooks {
+    readonly config: HookConfig;
+    /** Events or hook types present but not supported (listed, never run). */
+    readonly unsupported: readonly string[];
+}
+/** Accepts `{hooks: {...}}` (hooks.json, settings) or the event map itself. */
+export declare function parseHookConfig(raw: unknown): ParsedHooks;
+/** Merges several hook configurations (a plugin's hooks.json and manifest `hooks`). */
+export declare function mergeHookConfigs(configs: readonly HookConfig[]): HookConfig;
+export declare function hookCount(config: HookConfig): number;
+/** One line per hook, for approval modals and `/plugins show`. */
+export declare function describeHookConfig(config: HookConfig): string[];
+/** Synorch tool → Claude Code tool names a Claude plugin's matcher may use. */
+export declare const CLAUDE_TOOL_NAMES: Readonly<Record<string, readonly string[]>>;
+/** The name a hook sees as `tool_name`: the Claude name when there is one, else Synorch's. */
+export declare function claudeToolName(tool: string): string;
+/** Synorch arguments in Claude Code's `tool_input` shape (original keys kept alongside). */
+export declare function claudeToolInput(tool: string, args: Readonly<Record<string, unknown>>, workspaceRoot: string): Record<string, unknown>;
+/**
+ * Claude Code's matcher rules: empty / `*` matches all; only letters, digits, `_`, `-`, spaces, `|`
+ * and `,` → exact names separated by `|` or `,`; anything else → an unanchored regular expression.
+ */
+export declare function matcherMatches(matcher: string | undefined, candidates: readonly string[]): boolean;
+export declare const HOOK_APPROVALS_FILE = "hook-approvals.json";
+export interface HookApprovals {
+    readonly schema_version: 1;
+    readonly approved: Readonly<Record<string, {
+        readonly digest: string;
+        readonly approved_at: string;
+    }>>;
+}
+export declare function readHookApprovals(home: string): Promise<HookApprovals>;
+/** What an approval binds to: the hook definitions and the plugin directory (a new version re-asks). */
+export declare function hookDigest(config: HookConfig, root: string): string;
+export declare function approveHooks(home: string, key: string, digest: string, now?: Date): Promise<void>;
+export declare function revokeHooks(home: string, key: string): Promise<boolean>;
+export type HookOrigin = "user" | "synorch" | "claude";
+/** `active` runs; `pending` was never approved; `changed` was approved for other definitions. */
+export type HookSourceState = "active" | "pending" | "changed";
+export interface HookSource {
+    /** `user`, or the plugin key (`name`, Claude's `name@marketplace`). */
+    readonly key: string;
+    readonly origin: HookOrigin;
+    readonly config: HookConfig;
+    readonly digest: string;
+    readonly state: HookSourceState;
+    readonly pluginRoot: string | undefined;
+    readonly pluginData: string | undefined;
+}
+export interface HookPluginInput {
+    readonly key: string;
+    readonly origin: "synorch" | "claude";
+    readonly root: string;
+    readonly data: string;
+    readonly config: HookConfig;
+}
+export declare function hookSources(input: {
+    readonly user: HookConfig;
+    readonly plugins: readonly HookPluginInput[];
+    readonly approvals: HookApprovals;
+}): HookSource[];
+export declare const HOOK_OUTPUT_LIMIT: number;
+export declare const HOOK_DEFAULT_TIMEOUT_SECONDS = 60;
+export declare const HOOK_PROMPT_TIMEOUT_SECONDS = 30;
+export declare const HOOK_MAX_TIMEOUT_SECONDS = 600;
+export interface HookProcessResult {
+    readonly code: number | null;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly timedOut: boolean;
+    readonly error: string | undefined;
+}
+export type HookProcessRunner = (hook: HookCommand, stdin: string, options: {
+    readonly cwd: string;
+    readonly env: Readonly<Record<string, string>>;
+    readonly timeoutMs: number;
+    readonly signal: AbortSignal;
+}) => Promise<HookProcessResult>;
+/**
+ * Runs one command hook: exec form (`args` set) spawns `command` directly; shell form goes to
+ * `SYNORCH_HOOK_SHELL`, else `/bin/sh -c` (Git Bash on Windows when installed, cmd otherwise).
+ * Output beyond `HOOK_OUTPUT_LIMIT` per stream is dropped; the timeout kills the process.
+ */
+export declare const defaultHookProcessRunner: HookProcessRunner;
+export interface HookRunContext {
+    readonly sessionId: string;
+    readonly cwd: string;
+    /** Synorch's permission mode (sent as Claude's `permission_mode`). */
+    readonly permissionMode: string | undefined;
+    /** The step runs on a Claude Code native route: Claude-sourced hooks are skipped (Claude runs them). */
+    readonly claudeNative: boolean;
+    /** Only these origins run (the Claude-native built-in tool check passes `["user", "synorch"]`). */
+    readonly origins?: readonly HookOrigin[];
+    readonly signal: AbortSignal;
+}
+export interface HookOutcome {
+    /** A hook blocked (exit 2, `decision: "block"`, `continue: false`, `permissionDecision: "deny"`). */
+    readonly blocked: boolean;
+    readonly reason: string | undefined;
+    /** PreToolUse `permissionDecision: "ask"`: an allowed call asks first. */
+    readonly ask: boolean;
+    /** Context for the model (additionalContext, plain stdout where Claude reads it). */
+    readonly context: readonly string[];
+    /** Notes for the user (systemMessage, hook errors, timeouts). */
+    readonly messages: readonly string[];
+    /** How many hooks ran. */
+    readonly ran: number;
+}
+export interface HookEngineOptions {
+    readonly env: Readonly<Record<string, string | undefined>>;
+    readonly sources: () => readonly HookSource[];
+    readonly run?: HookProcessRunner;
+}
+export interface HookEngine {
+    /** Every hook source with its approval state. */
+    sources(): readonly HookSource[];
+    /** Whether any active hook is registered for the event (cheap check before building payloads). */
+    has(event: HookEvent, context: Pick<HookRunContext, "claudeNative" | "origins">): boolean;
+    /**
+     * Runs the matching active hooks of an event in order and folds their answers. `match` is what
+     * the matcher is tested against (tool names for tool events, the start source for SessionStart).
+     */
+    run(event: HookEvent, payload: Readonly<Record<string, unknown>>, match: readonly string[], context: HookRunContext): Promise<HookOutcome>;
+}
+export declare function createHookEngine(options: HookEngineOptions): HookEngine;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/harness/cli/extensions/hooks.d.ts.map

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