@keel_flow/cli 0.2.0

package/dist/memory.js

@@ -0,0 +1,84 @@
+import { resolve } from "node:path";
+import pc from "picocolors";
+import { appendMemory, readMemory, removeMemory, searchMemory, } from "@keel_flow/memory";
+import { createCliEmitter } from "./telemetry-helper.js";
+function scopeOf(opts) {
+    return opts.global ? "global" : "project";
+}
+export async function runMemoryList(opts) {
+    const cwd = resolve(opts.cwd);
+    const scope = scopeOf(opts);
+    const entries = await readMemory({ cwd, scope });
+    if (entries.length === 0) {
+        process.stdout.write(pc.dim(`(no memory entries in ${scope} scope)\n`));
+        return;
+    }
+    for (const e of entries) {
+        process.stdout.write(`${pc.cyan(e.id.slice(0, 12))}  ${pc.dim(e.timestamp)}  ${pc.dim(`[${e.origin}]`)}\n` +
+            `  ${e.fact.replace(/\n/g, "\n  ")}\n\n`);
+    }
+}
+export async function runMemoryAdd(opts) {
+    const cwd = resolve(opts.cwd);
+    const scope = scopeOf(opts);
+    const result = await appendMemory({ cwd, scope, fact: opts.fact });
+    const { emitter, sessionId } = createCliEmitter({ command: "memory", cwd });
+    emitter?.emit({
+        sessionId,
+        parentEventId: null,
+        workspaceId: null,
+        triggeredBy: { kind: "user" },
+        kind: "memory.added",
+        payload: { entryId: result.id, scope, path: result.path },
+    });
+    if (emitter)
+        await emitter.close();
+    process.stdout.write(pc.green(`✓ Added to ${scope} memory (id=${result.id.slice(0, 12)})\n`) +
+        pc.dim(`  ${result.path}\n`));
+}
+export async function runMemoryShow(opts) {
+    const cwd = resolve(opts.cwd);
+    const scope = scopeOf(opts);
+    const hits = await searchMemory({ cwd, scope, pattern: opts.pattern });
+    if (hits.length === 0) {
+        process.stdout.write(pc.dim(`(no matches for "${opts.pattern}" in ${scope} memory)\n`));
+        return;
+    }
+    for (const e of hits) {
+        process.stdout.write(`${pc.cyan(e.id.slice(0, 12))}  ${pc.dim(e.timestamp)}  ${pc.dim(`[${e.origin}]`)}\n` +
+            `  ${e.fact.replace(/\n/g, "\n  ")}\n\n`);
+    }
+}
+export async function runMemoryRemove(opts) {
+    const cwd = resolve(opts.cwd);
+    const all = await readMemory({ cwd });
+    const match = all.find((e) => e.id === opts.id || e.id.startsWith(opts.id));
+    if (!match) {
+        process.stderr.write(pc.red(`No matching entry for id=${opts.id}\n`));
+        process.exitCode = 1;
+        return;
+    }
+    const result = await removeMemory({
+        cwd,
+        scope: match.origin,
+        id: match.id,
+    });
+    if (!result.removed) {
+        process.stderr.write(pc.red(`Failed to remove entry id=${opts.id}\n`));
+        process.exitCode = 1;
+        return;
+    }
+    const { emitter, sessionId } = createCliEmitter({ command: "memory", cwd });
+    emitter?.emit({
+        sessionId,
+        parentEventId: null,
+        workspaceId: null,
+        triggeredBy: { kind: "user" },
+        kind: "memory.removed",
+        payload: { entryId: match.id, scope: match.origin },
+    });
+    if (emitter)
+        await emitter.close();
+    process.stdout.write(pc.green(`✓ Removed entry id=${match.id.slice(0, 12)} from ${match.origin} memory\n`));
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/orchestrate.d.ts

@@ -0,0 +1,61 @@
+import { createPrincipleRegistry, type CommandRuleSet } from "@keel_flow/core";
+import type { ArchitectureMap } from "@keel_flow/schema";
+import { type ModelProvider, type ProviderKind, type ToolDefinition } from "@keel_flow/runtime";
+import { type AgentTrustLevel, type AgentPolicyOverrides, type EffectivePolicy } from "@keel_flow/agent-policy";
+import { createCliEmitter } from "./telemetry-helper.js";
+export interface OrchestrateOptions {
+    task: string;
+    cwd?: string;
+    provider?: string;
+    model?: string;
+    maxIterations?: number;
+    noQuestions?: boolean;
+    dryRun?: boolean;
+    json?: string;
+    stdinAnswer?: () => Promise<string>;
+    agentTrustLevel?: AgentTrustLevel;
+    agentPolicyOverrides?: AgentPolicyOverrides;
+}
+export interface OrchestrateResult {
+    sessionId: string;
+    finalMessage: string;
+    toolCalls: number;
+    iterations: number;
+    verifyExitCode: number | null;
+}
+export declare function isProtectedWritePath(targetPath: string, cwd: string): boolean;
+export interface AllowCommandOptions {
+    allowPrivileged?: boolean;
+}
+export declare function isAllowedCommand(commandLine: string, _options?: AllowCommandOptions): boolean;
+export declare function isPathSafe(targetPath: string, cwd: string): boolean;
+export interface ResolvedProvider {
+    kind: ProviderKind;
+    provider: ModelProvider;
+    model: string | undefined;
+}
+export interface ResolveProviderArgs {
+    providerKind: ProviderKind;
+    model?: string;
+    fetchImpl?: typeof fetch;
+}
+export declare function resolveProviderConfig(args: ResolveProviderArgs): Promise<ResolvedProvider>;
+export declare function renderCommandRulesPrompt(ruleSet: CommandRuleSet): string;
+interface BuildToolsArgs {
+    cwd: string;
+    commandRules: CommandRuleSet;
+    dryRun: boolean;
+    architecture: ArchitectureMap;
+    principlesRegistry: ReturnType<typeof createPrincipleRegistry>;
+    provider: ModelProvider;
+    model: string | undefined;
+    parentSessionId: string;
+    parentEmitter: ReturnType<typeof createCliEmitter>["emitter"];
+    onDecompose: () => void;
+    policy: EffectivePolicy;
+    sessionBaseRef: string | null;
+}
+export declare function buildOrchestrateTools(args: BuildToolsArgs): ToolDefinition[];
+export declare function runOrchestrate(opts: OrchestrateOptions): Promise<OrchestrateResult>;
+export {};
+//# sourceMappingURL=orchestrate.d.ts.map

package/dist/orchestrate.d.ts.map

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