octoflow-core 1.0.0

package/dist/cli/format/output.js

@@ -0,0 +1,73 @@
+import { sanitizeRecord } from "../../utils/sanitize.js";
+import { wrapOutput } from "../contracts/output.js";
+const PRIORITY_KEYS = ["id", "name", "status", "state", "kind", "backend"];
+function stringifyPrimitive(v) {
+  switch (typeof v) {
+    case "string":
+      return v;
+    case "number":
+    case "boolean":
+    case "bigint":
+      return String(v);
+    case "symbol":
+      return String(v);
+    case "undefined":
+      return "";
+    case "function":
+      return "";
+    case "object":
+      return JSON.stringify(v) ?? "";
+    default:
+      return "";
+  }
+}
+function formatInlineRecord(record) {
+  const parts = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const key of PRIORITY_KEYS) {
+    const v = record[key];
+    if (v !== void 0 && v !== null) {
+      parts.push(`${key}=${stringifyPrimitive(v)}`);
+      seen.add(key);
+    }
+  }
+  for (const [key, value] of Object.entries(record)) {
+    if (seen.has(key)) continue;
+    if (value === void 0 || value === null) continue;
+    if (typeof value === "object") continue;
+    if (typeof value === "function" || typeof value === "symbol") continue;
+    parts.push(`${key}=${stringifyPrimitive(value)}`);
+  }
+  return parts.join("  ");
+}
+function formatTextValue(data, label) {
+  const lines = [];
+  if (label) lines.push(`${label}:`);
+  if (Array.isArray(data)) {
+    for (const item of data) {
+      if (typeof item === "object" && item !== null && !Array.isArray(item)) {
+        lines.push(`  ${formatInlineRecord(item)}`);
+      } else {
+        lines.push(`  ${String(item)}`);
+      }
+    }
+  } else if (typeof data === "object" && data !== null) {
+    lines.push(formatInlineRecord(data));
+  } else {
+    lines.push(String(data));
+  }
+  return lines.join("\n");
+}
+function printOutput(data, opts = {}) {
+  const sanitized = sanitizeRecord(data);
+  if (opts.json) {
+    const output = JSON.stringify(wrapOutput(sanitized), null, 2);
+    process.stdout.write(output + "\n");
+    return;
+  }
+  process.stdout.write(formatTextValue(sanitized, opts.label) + "\n");
+}
+export {
+  printOutput
+};
+//# sourceMappingURL=output.js.map

package/dist/cli/format/output.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli/format/output.ts"],
+  "sourcesContent": ["import { sanitizeRecord } from '../../utils/sanitize.js';\nimport { wrapOutput } from '../contracts/output.js';\n\nconst PRIORITY_KEYS = ['id', 'name', 'status', 'state', 'kind', 'backend'];\n\nfunction stringifyPrimitive(v: unknown): string {\n  switch (typeof v) {\n    case 'string':\n      return v;\n    case 'number':\n    case 'boolean':\n    case 'bigint':\n      return String(v);\n    case 'symbol':\n      return String(v);\n    case 'undefined':\n      return '';\n    case 'function':\n      return '';\n    case 'object':\n      return JSON.stringify(v) ?? '';\n    default:\n      return '';\n  }\n}\n\nfunction formatInlineRecord(record: Record<string, unknown>): string {\n  const parts: string[] = [];\n  const seen = new Set<string>();\n\n  for (const key of PRIORITY_KEYS) {\n    const v = record[key];\n    if (v !== undefined && v !== null) {\n      parts.push(`${key}=${stringifyPrimitive(v)}`);\n      seen.add(key);\n    }\n  }\n\n  for (const [key, value] of Object.entries(record)) {\n    if (seen.has(key)) continue;\n    if (value === undefined || value === null) continue;\n    if (typeof value === 'object') continue;\n    if (typeof value === 'function' || typeof value === 'symbol') continue;\n    parts.push(`${key}=${stringifyPrimitive(value)}`);\n  }\n\n  return parts.join('  ');\n}\n\nfunction formatTextValue(data: unknown, label?: string): string {\n  const lines: string[] = [];\n\n  if (label) lines.push(`${label}:`);\n\n  if (Array.isArray(data)) {\n    for (const item of data) {\n      if (typeof item === 'object' && item !== null && !Array.isArray(item)) {\n        lines.push(`  ${formatInlineRecord(item as Record<string, unknown>)}`);\n      } else {\n        lines.push(`  ${String(item)}`);\n      }\n    }\n  } else if (typeof data === 'object' && data !== null) {\n    lines.push(formatInlineRecord(data as Record<string, unknown>));\n  } else {\n    lines.push(String(data));\n  }\n\n  return lines.join('\\n');\n}\n\nexport function printOutput(\n  data: unknown,\n  opts: { json?: boolean; label?: string } = {}\n): void {\n  const sanitized = sanitizeRecord(data);\n\n  if (opts.json) {\n    const output = JSON.stringify(wrapOutput(sanitized), null, 2);\n    process.stdout.write(output + '\\n');\n    return;\n  }\n\n  process.stdout.write(formatTextValue(sanitized, opts.label) + '\\n');\n}\n"],
+  "mappings": "AAAA,SAAS,sBAAsB;AAC/B,SAAS,kBAAkB;AAE3B,MAAM,gBAAgB,CAAC,MAAM,QAAQ,UAAU,SAAS,QAAQ,SAAS;AAEzE,SAAS,mBAAmB,GAAoB;AAC9C,UAAQ,OAAO,GAAG;AAAA,IAChB,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO,OAAO,CAAC;AAAA,IACjB,KAAK;AACH,aAAO,OAAO,CAAC;AAAA,IACjB,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,KAAK,UAAU,CAAC,KAAK;AAAA,IAC9B;AACE,aAAO;AAAA,EACX;AACF;AAEA,SAAS,mBAAmB,QAAyC;AACnE,QAAM,QAAkB,CAAC;AACzB,QAAM,OAAO,oBAAI,IAAY;AAE7B,aAAW,OAAO,eAAe;AAC/B,UAAM,IAAI,OAAO,GAAG;AACpB,QAAI,MAAM,UAAa,MAAM,MAAM;AACjC,YAAM,KAAK,GAAG,GAAG,IAAI,mBAAmB,CAAC,CAAC,EAAE;AAC5C,WAAK,IAAI,GAAG;AAAA,IACd;AAAA,EACF;AAEA,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,GAAG;AACjD,QAAI,KAAK,IAAI,GAAG,EAAG;AACnB,QAAI,UAAU,UAAa,UAAU,KAAM;AAC3C,QAAI,OAAO,UAAU,SAAU;AAC/B,QAAI,OAAO,UAAU,cAAc,OAAO,UAAU,SAAU;AAC9D,UAAM,KAAK,GAAG,GAAG,IAAI,mBAAmB,KAAK,CAAC,EAAE;AAAA,EAClD;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;AAEA,SAAS,gBAAgB,MAAe,OAAwB;AAC9D,QAAM,QAAkB,CAAC;AAEzB,MAAI,MAAO,OAAM,KAAK,GAAG,KAAK,GAAG;AAEjC,MAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,eAAW,QAAQ,MAAM;AACvB,UAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,CAAC,MAAM,QAAQ,IAAI,GAAG;AACrE,cAAM,KAAK,KAAK,mBAAmB,IAA+B,CAAC,EAAE;AAAA,MACvE,OAAO;AACL,cAAM,KAAK,KAAK,OAAO,IAAI,CAAC,EAAE;AAAA,MAChC;AAAA,IACF;AAAA,EACF,WAAW,OAAO,SAAS,YAAY,SAAS,MAAM;AACpD,UAAM,KAAK,mBAAmB,IAA+B,CAAC;AAAA,EAChE,OAAO;AACL,UAAM,KAAK,OAAO,IAAI,CAAC;AAAA,EACzB;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;AAEO,SAAS,YACd,MACA,OAA2C,CAAC,GACtC;AACN,QAAM,YAAY,eAAe,IAAI;AAErC,MAAI,KAAK,MAAM;AACb,UAAM,SAAS,KAAK,UAAU,WAAW,SAAS,GAAG,MAAM,CAAC;AAC5D,YAAQ,OAAO,MAAM,SAAS,IAAI;AAClC;AAAA,EACF;AAEA,UAAQ,OAAO,MAAM,gBAAgB,WAAW,KAAK,KAAK,IAAI,IAAI;AACpE;",
+  "names": []
+}

package/dist/cli/format/text.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedEvent } from '../../domain/contracts/messages.js';
+export declare function formatEvent(event: ParsedEvent, backend?: string, debug?: boolean): string | null;
+//# sourceMappingURL=text.d.ts.map

package/dist/cli/format/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/cli/format/text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAwCtE,wBAAgB,WAAW,CACzB,KAAK,EAAE,WAAW,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,UAAQ,GACZ,MAAM,GAAG,IAAI,CAsCf"}

package/dist/cli/format/text.js

@@ -0,0 +1,60 @@
+const BACKEND_HOOKS = {
+  codex: {
+    onTool: (e) => `  \u{1F4BB} ${e.name ?? "Bash"}`
+  },
+  cursor: {
+    onTool: (e) => `  ${e.icon ?? "\u{1F527}"} ${e.name ?? "tool"}`
+  }
+};
+function defaultFormatTool(event) {
+  return `  \u{1F527} ${event.name ?? "tool"}`;
+}
+function defaultFormatThinking(event) {
+  return event.text ?? "";
+}
+function defaultFormatResult(event) {
+  const parts = [];
+  if (event.isError) parts.push("[error]");
+  if (event.text) parts.push(event.text);
+  if (event.usage) {
+    parts.push(
+      `(${event.usage.inputTokens}/${event.usage.outputTokens} tokens)`
+    );
+  }
+  if (event.costUsd !== void 0 && event.costUsd !== null) {
+    parts.push(`$${event.costUsd.toFixed(4)}`);
+  }
+  return parts.join(" ");
+}
+function formatEvent(event, backend, debug = false) {
+  const hooks = backend ? BACKEND_HOOKS[backend] : void 0;
+  switch (event.type) {
+    case "thinking_start":
+      return null;
+    case "thinking":
+      return (hooks?.onThinking ?? defaultFormatThinking)(event);
+    case "text":
+      return event.text ?? "";
+    case "tool":
+      return (hooks?.onTool ?? defaultFormatTool)(event);
+    case "result":
+      return (hooks?.onResult ?? defaultFormatResult)(event);
+    case "init":
+      return debug ? `[init] session=${event.sessionId ?? "unknown"}` : null;
+    case "input-required":
+      return "[input-required]";
+    case "auth-required":
+      return "[auth-required]";
+    case "tool_call_result":
+    case "tool_call_stop":
+      return debug ? JSON.stringify(event) : null;
+    case "parse_error":
+      return `[parse-error ${event.backend ?? "backend"}] ${event.reason ?? "unknown"}`;
+    default:
+      return debug ? JSON.stringify(event) : null;
+  }
+}
+export {
+  formatEvent
+};
+//# sourceMappingURL=text.js.map

package/dist/cli/format/text.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/cli/format/text.ts"],
+  "sourcesContent": ["import type { ParsedEvent } from '../../domain/contracts/messages.js';\n\ninterface FormatHooks {\n  onTool?: (event: ParsedEvent) => string;\n  onThinking?: (event: ParsedEvent) => string;\n  onResult?: (event: ParsedEvent) => string;\n}\n\nconst BACKEND_HOOKS: Record<string, FormatHooks> = {\n  codex: {\n    onTool: (e) => `  \\u{1F4BB} ${e.name ?? 'Bash'}`,\n  },\n  cursor: {\n    onTool: (e) => `  ${e.icon ?? '\\u{1F527}'} ${e.name ?? 'tool'}`,\n  },\n};\n\nfunction defaultFormatTool(event: ParsedEvent): string {\n  return `  \\u{1F527} ${event.name ?? 'tool'}`;\n}\n\nfunction defaultFormatThinking(event: ParsedEvent): string {\n  return event.text ?? '';\n}\n\nfunction defaultFormatResult(event: ParsedEvent): string {\n  const parts: string[] = [];\n  if (event.isError) parts.push('[error]');\n  if (event.text) parts.push(event.text);\n  if (event.usage) {\n    parts.push(\n      `(${event.usage.inputTokens}/${event.usage.outputTokens} tokens)`\n    );\n  }\n  if (event.costUsd !== undefined && event.costUsd !== null) {\n    parts.push(`$${event.costUsd.toFixed(4)}`);\n  }\n  return parts.join(' ');\n}\n\nexport function formatEvent(\n  event: ParsedEvent,\n  backend?: string,\n  debug = false\n): string | null {\n  const hooks = backend ? BACKEND_HOOKS[backend] : undefined;\n\n  switch (event.type) {\n    case 'thinking_start':\n      return null;\n\n    case 'thinking':\n      return (hooks?.onThinking ?? defaultFormatThinking)(event);\n\n    case 'text':\n      return event.text ?? '';\n\n    case 'tool':\n      return (hooks?.onTool ?? defaultFormatTool)(event);\n\n    case 'result':\n      return (hooks?.onResult ?? defaultFormatResult)(event);\n\n    case 'init':\n      return debug ? `[init] session=${event.sessionId ?? 'unknown'}` : null;\n\n    case 'input-required':\n      return '[input-required]';\n\n    case 'auth-required':\n      return '[auth-required]';\n\n    case 'tool_call_result':\n    case 'tool_call_stop':\n      return debug ? JSON.stringify(event) : null;\n\n    case 'parse_error':\n      return `[parse-error ${event.backend ?? 'backend'}] ${event.reason ?? 'unknown'}`;\n\n    default:\n      return debug ? JSON.stringify(event) : null;\n  }\n}\n"],
+  "mappings": "AAQA,MAAM,gBAA6C;AAAA,EACjD,OAAO;AAAA,IACL,QAAQ,CAAC,MAAM,eAAe,EAAE,QAAQ,MAAM;AAAA,EAChD;AAAA,EACA,QAAQ;AAAA,IACN,QAAQ,CAAC,MAAM,KAAK,EAAE,QAAQ,WAAW,IAAI,EAAE,QAAQ,MAAM;AAAA,EAC/D;AACF;AAEA,SAAS,kBAAkB,OAA4B;AACrD,SAAO,eAAe,MAAM,QAAQ,MAAM;AAC5C;AAEA,SAAS,sBAAsB,OAA4B;AACzD,SAAO,MAAM,QAAQ;AACvB;AAEA,SAAS,oBAAoB,OAA4B;AACvD,QAAM,QAAkB,CAAC;AACzB,MAAI,MAAM,QAAS,OAAM,KAAK,SAAS;AACvC,MAAI,MAAM,KAAM,OAAM,KAAK,MAAM,IAAI;AACrC,MAAI,MAAM,OAAO;AACf,UAAM;AAAA,MACJ,IAAI,MAAM,MAAM,WAAW,IAAI,MAAM,MAAM,YAAY;AAAA,IACzD;AAAA,EACF;AACA,MAAI,MAAM,YAAY,UAAa,MAAM,YAAY,MAAM;AACzD,UAAM,KAAK,IAAI,MAAM,QAAQ,QAAQ,CAAC,CAAC,EAAE;AAAA,EAC3C;AACA,SAAO,MAAM,KAAK,GAAG;AACvB;AAEO,SAAS,YACd,OACA,SACA,QAAQ,OACO;AACf,QAAM,QAAQ,UAAU,cAAc,OAAO,IAAI;AAEjD,UAAQ,MAAM,MAAM;AAAA,IAClB,KAAK;AACH,aAAO;AAAA,IAET,KAAK;AACH,cAAQ,OAAO,cAAc,uBAAuB,KAAK;AAAA,IAE3D,KAAK;AACH,aAAO,MAAM,QAAQ;AAAA,IAEvB,KAAK;AACH,cAAQ,OAAO,UAAU,mBAAmB,KAAK;AAAA,IAEnD,KAAK;AACH,cAAQ,OAAO,YAAY,qBAAqB,KAAK;AAAA,IAEvD,KAAK;AACH,aAAO,QAAQ,kBAAkB,MAAM,aAAa,SAAS,KAAK;AAAA,IAEpE,KAAK;AACH,aAAO;AAAA,IAET,KAAK;AACH,aAAO;AAAA,IAET,KAAK;AAAA,IACL,KAAK;AACH,aAAO,QAAQ,KAAK,UAAU,KAAK,IAAI;AAAA,IAEzC,KAAK;AACH,aAAO,gBAAgB,MAAM,WAAW,SAAS,KAAK,MAAM,UAAU,SAAS;AAAA,IAEjF;AACE,aAAO,QAAQ,KAAK,UAAU,KAAK,IAAI;AAAA,EAC3C;AACF;",
+  "names": []
+}

package/dist/cli/framework-workspace.d.ts

@@ -0,0 +1,30 @@
+export interface FrameworkAgentInfo {
+    name: string;
+    path: string;
+}
+export interface FrameworkManifest {
+    agents: FrameworkAgentInfo[];
+    generatedAt: string;
+    roles: string[];
+    skills: string[];
+    workspaceDir: string;
+}
+export interface InitFrameworkWorkspaceResult {
+    configPath: string;
+    created: string[];
+    skipped: string[];
+    workspaceDir: string;
+}
+export declare function initFrameworkWorkspace(options: {
+    cwd?: string;
+    dir: string;
+    force?: boolean;
+}): Promise<InitFrameworkWorkspaceResult>;
+export declare function buildFrameworkManifest(options: {
+    cwd?: string;
+    dir: string;
+    outDir: string;
+}): Promise<FrameworkManifest & {
+    manifestPath: string;
+}>;
+//# sourceMappingURL=framework-workspace.d.ts.map

package/dist/cli/framework-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-workspace.d.ts","sourceRoot":"","sources":["../../src/cli/framework-workspace.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,4BAA4B;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAyDD,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAoExC;AAED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,iBAAiB,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAiCxD"}

package/dist/cli/framework-workspace.js

@@ -0,0 +1,148 @@
+import { mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { basename, dirname, extname, join, relative } from "node:path";
+import { CONFIG_TEMPLATE } from "../config/config.js";
+const AGENT_EXTENSIONS = /* @__PURE__ */ new Set([".js", ".mjs", ".ts", ".mts"]);
+const MARKDOWN_EXTENSION = ".md";
+async function pathExists(path) {
+  try {
+    await readFile(path);
+    return true;
+  } catch (error) {
+    if (error.code === "ENOENT") return false;
+    throw error;
+  }
+}
+async function writeIfMissing(path, content, force, touched) {
+  await mkdir(dirname(path), { recursive: true });
+  if (!force && await pathExists(path)) {
+    touched.skipped.push(path);
+    return;
+  }
+  await writeFile(path, content);
+  touched.created.push(path);
+}
+async function listFiles(root, extensions) {
+  try {
+    const entries = await readdir(root, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+      const path = join(root, entry.name);
+      if (entry.isDirectory()) {
+        files.push(...await listFiles(path, extensions));
+      } else if (entry.isFile() && extensions.has(extname(entry.name))) {
+        files.push(path);
+      }
+    }
+    return files;
+  } catch (error) {
+    if (error.code === "ENOENT") return [];
+    throw error;
+  }
+}
+function agentNameFromPath(path) {
+  return basename(path, extname(path));
+}
+async function initFrameworkWorkspace(options) {
+  const cwd = options.cwd ?? process.cwd();
+  const workspaceDir = join(cwd, options.dir);
+  const force = options.force ?? false;
+  const result = {
+    configPath: join(cwd, "octoflow.config.json"),
+    created: [],
+    skipped: [],
+    workspaceDir
+  };
+  await mkdir(join(workspaceDir, "agents"), { recursive: true });
+  await mkdir(join(workspaceDir, "roles"), { recursive: true });
+  await mkdir(join(workspaceDir, "skills"), { recursive: true });
+  await writeIfMissing(
+    result.configPath,
+    `${JSON.stringify(CONFIG_TEMPLATE, null, 2)}
+`,
+    force,
+    result
+  );
+  await writeIfMissing(
+    join(workspaceDir, "roles", "assistant.md"),
+    `---
+description: Default assistant role for local framework-mode projects.
+---
+
+You are a concise project assistant. Prefer direct answers, cite files when relevant,
+and ask before taking destructive actions.
+`,
+    force,
+    result
+  );
+  await writeIfMissing(
+    join(workspaceDir, "agents", "hello.ts"),
+    `import { createAgent, extractText } from 'octoflow-core';
+
+export async function run(message = 'Say hello from OctoFlow.'): Promise<string> {
+  const agent = await createAgent({
+    priority: ['claude-code-cli', 'anthropic-api', 'openai-api', 'ollama'],
+    context: {
+      identity: 'You are the hello agent for this project.',
+      instructions: 'Answer briefly and clearly.',
+    },
+  });
+
+  try {
+    const result = await agent.sendMessage({ message });
+    return extractText(result);
+  } finally {
+    await agent.close();
+  }
+}
+
+if (import.meta.url === \`file://\${process.argv[1]}\`) {
+  run(process.argv.slice(2).join(' ') || undefined)
+    .then((text) => process.stdout.write(\`\${text}\\n\`))
+    .catch((error) => {
+      process.stderr.write(\`\${error instanceof Error ? error.message : String(error)}\\n\`);
+      process.exitCode = 1;
+    });
+}
+`,
+    force,
+    result
+  );
+  return result;
+}
+async function buildFrameworkManifest(options) {
+  const cwd = options.cwd ?? process.cwd();
+  const workspaceDir = join(cwd, options.dir);
+  const outDir = join(cwd, options.outDir);
+  const agentFiles = await listFiles(
+    join(workspaceDir, "agents"),
+    AGENT_EXTENSIONS
+  );
+  const roleFiles = await listFiles(
+    join(workspaceDir, "roles"),
+    /* @__PURE__ */ new Set([MARKDOWN_EXTENSION])
+  );
+  const skillFiles = await listFiles(
+    join(workspaceDir, "skills"),
+    /* @__PURE__ */ new Set([MARKDOWN_EXTENSION])
+  );
+  const manifest = {
+    agents: agentFiles.sort().map((path) => ({
+      name: agentNameFromPath(path),
+      path: relative(cwd, path)
+    })),
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    roles: roleFiles.sort().map((path) => relative(cwd, path)),
+    skills: skillFiles.sort().map((path) => relative(cwd, path)),
+    workspaceDir: relative(cwd, workspaceDir) || "."
+  };
+  const manifestPath = join(outDir, "manifest.json");
+  await mkdir(outDir, { recursive: true });
+  await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}
+`);
+  return { ...manifest, manifestPath };
+}
+export {
+  buildFrameworkManifest,
+  initFrameworkWorkspace
+};
+//# sourceMappingURL=framework-workspace.js.map

package/dist/cli/framework-workspace.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/cli/framework-workspace.ts"],
+  "sourcesContent": ["import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises';\nimport { basename, dirname, extname, join, relative } from 'node:path';\n\nimport { CONFIG_TEMPLATE } from '../config/config.js';\n\nconst AGENT_EXTENSIONS = new Set(['.js', '.mjs', '.ts', '.mts']);\nconst MARKDOWN_EXTENSION = '.md';\n\nexport interface FrameworkAgentInfo {\n  name: string;\n  path: string;\n}\n\nexport interface FrameworkManifest {\n  agents: FrameworkAgentInfo[];\n  generatedAt: string;\n  roles: string[];\n  skills: string[];\n  workspaceDir: string;\n}\n\nexport interface InitFrameworkWorkspaceResult {\n  configPath: string;\n  created: string[];\n  skipped: string[];\n  workspaceDir: string;\n}\n\nasync function pathExists(path: string): Promise<boolean> {\n  try {\n    await readFile(path);\n    return true;\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return false;\n    throw error;\n  }\n}\n\nasync function writeIfMissing(\n  path: string,\n  content: string,\n  force: boolean,\n  touched: InitFrameworkWorkspaceResult\n): Promise<void> {\n  await mkdir(dirname(path), { recursive: true });\n\n  if (!force && (await pathExists(path))) {\n    touched.skipped.push(path);\n    return;\n  }\n\n  await writeFile(path, content);\n  touched.created.push(path);\n}\n\nasync function listFiles(\n  root: string,\n  extensions: Set<string>\n): Promise<string[]> {\n  try {\n    const entries = await readdir(root, { withFileTypes: true });\n    const files: string[] = [];\n\n    for (const entry of entries) {\n      const path = join(root, entry.name);\n      if (entry.isDirectory()) {\n        files.push(...(await listFiles(path, extensions)));\n      } else if (entry.isFile() && extensions.has(extname(entry.name))) {\n        files.push(path);\n      }\n    }\n\n    return files;\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'ENOENT') return [];\n    throw error;\n  }\n}\n\nfunction agentNameFromPath(path: string): string {\n  return basename(path, extname(path));\n}\n\nexport async function initFrameworkWorkspace(options: {\n  cwd?: string;\n  dir: string;\n  force?: boolean;\n}): Promise<InitFrameworkWorkspaceResult> {\n  const cwd = options.cwd ?? process.cwd();\n  const workspaceDir = join(cwd, options.dir);\n  const force = options.force ?? false;\n  const result: InitFrameworkWorkspaceResult = {\n    configPath: join(cwd, 'octoflow.config.json'),\n    created: [],\n    skipped: [],\n    workspaceDir,\n  };\n\n  await mkdir(join(workspaceDir, 'agents'), { recursive: true });\n  await mkdir(join(workspaceDir, 'roles'), { recursive: true });\n  await mkdir(join(workspaceDir, 'skills'), { recursive: true });\n\n  await writeIfMissing(\n    result.configPath,\n    `${JSON.stringify(CONFIG_TEMPLATE, null, 2)}\\n`,\n    force,\n    result\n  );\n  await writeIfMissing(\n    join(workspaceDir, 'roles', 'assistant.md'),\n    `---\ndescription: Default assistant role for local framework-mode projects.\n---\n\nYou are a concise project assistant. Prefer direct answers, cite files when relevant,\nand ask before taking destructive actions.\n`,\n    force,\n    result\n  );\n  await writeIfMissing(\n    join(workspaceDir, 'agents', 'hello.ts'),\n    `import { createAgent, extractText } from 'octoflow-core';\n\nexport async function run(message = 'Say hello from OctoFlow.'): Promise<string> {\n  const agent = await createAgent({\n    priority: ['claude-code-cli', 'anthropic-api', 'openai-api', 'ollama'],\n    context: {\n      identity: 'You are the hello agent for this project.',\n      instructions: 'Answer briefly and clearly.',\n    },\n  });\n\n  try {\n    const result = await agent.sendMessage({ message });\n    return extractText(result);\n  } finally {\n    await agent.close();\n  }\n}\n\nif (import.meta.url === \\`file://\\${process.argv[1]}\\`) {\n  run(process.argv.slice(2).join(' ') || undefined)\n    .then((text) => process.stdout.write(\\`\\${text}\\\\n\\`))\n    .catch((error) => {\n      process.stderr.write(\\`\\${error instanceof Error ? error.message : String(error)}\\\\n\\`);\n      process.exitCode = 1;\n    });\n}\n`,\n    force,\n    result\n  );\n\n  return result;\n}\n\nexport async function buildFrameworkManifest(options: {\n  cwd?: string;\n  dir: string;\n  outDir: string;\n}): Promise<FrameworkManifest & { manifestPath: string }> {\n  const cwd = options.cwd ?? process.cwd();\n  const workspaceDir = join(cwd, options.dir);\n  const outDir = join(cwd, options.outDir);\n  const agentFiles = await listFiles(\n    join(workspaceDir, 'agents'),\n    AGENT_EXTENSIONS\n  );\n  const roleFiles = await listFiles(\n    join(workspaceDir, 'roles'),\n    new Set([MARKDOWN_EXTENSION])\n  );\n  const skillFiles = await listFiles(\n    join(workspaceDir, 'skills'),\n    new Set([MARKDOWN_EXTENSION])\n  );\n\n  const manifest: FrameworkManifest = {\n    agents: agentFiles.sort().map((path) => ({\n      name: agentNameFromPath(path),\n      path: relative(cwd, path),\n    })),\n    generatedAt: new Date().toISOString(),\n    roles: roleFiles.sort().map((path) => relative(cwd, path)),\n    skills: skillFiles.sort().map((path) => relative(cwd, path)),\n    workspaceDir: relative(cwd, workspaceDir) || '.',\n  };\n  const manifestPath = join(outDir, 'manifest.json');\n\n  await mkdir(outDir, { recursive: true });\n  await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\\n`);\n\n  return { ...manifest, manifestPath };\n}\n"],
+  "mappings": "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",
+  "names": []
+}