@skaile/workspaces 1.16.0 → 2.1.0

package/dist/chunk-7GOCNYUV.js

@@ -0,0 +1,300 @@
+import { EventEmitter } from 'events';
+import { ulid } from 'ulid';
+
+// core/src/logging/log-store.ts
+var LEVEL_RANK = {
+  debug: 10,
+  info: 20,
+  warn: 30,
+  error: 40
+};
+var LogStore = class {
+  sessionId;
+  level;
+  sinks;
+  flushIntervalMs;
+  flushBatchSize;
+  buffer = [];
+  timer = null;
+  emitter = new EventEmitter();
+  closed = false;
+  constructor(opts) {
+    this.sessionId = opts.sessionId;
+    this.level = opts.level;
+    this.sinks = opts.sinks;
+    this.flushIntervalMs = opts.flushIntervalMs ?? 50;
+    this.flushBatchSize = opts.flushBatchSize ?? 100;
+    this.emitter.setMaxListeners(0);
+  }
+  getLevel() {
+    return this.level;
+  }
+  setLevel(level) {
+    this.level = level;
+  }
+  /** Append a sink after construction. Used by bridges (e.g. OnLogBridgeSink). */
+  addSink(sink) {
+    this.sinks.push(sink);
+  }
+  /** Returns true if the level is enabled. Used by createLogger to short-circuit. */
+  isEnabled(level) {
+    return LEVEL_RANK[level] >= LEVEL_RANK[this.level];
+  }
+  record(input) {
+    if (this.closed) return;
+    if (!this.isEnabled(input.level)) return;
+    const entry = {
+      id: ulid(),
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      sessionId: this.sessionId,
+      source: input.source,
+      level: input.level,
+      message: input.message,
+      data: input.data,
+      error: input.error
+    };
+    this.emitter.emit("entry", entry);
+    this.buffer.push(entry);
+    if (this.buffer.length >= this.flushBatchSize) {
+      this.flushSync();
+    } else if (this.flushIntervalMs > 0 && this.timer === null) {
+      this.timer = setTimeout(() => this.flushSync(), this.flushIntervalMs);
+    } else if (this.flushIntervalMs === 0) {
+      this.flushSync();
+    }
+  }
+  /** Subscribe to live entries. Returns an unsubscribe function. */
+  subscribe(handler) {
+    this.emitter.on("entry", handler);
+    return () => this.emitter.off("entry", handler);
+  }
+  /**
+   * Query stored log entries.
+   *
+   * Queries the first sink that supports querying (typically SQLiteSink).
+   * Returns empty result if no sink supports querying.
+   *
+   * @param q - Query parameters including filters and pagination
+   * @returns Query result with matching entries
+   */
+  query(q) {
+    for (const sink of this.sinks) {
+      if (sink.query) return sink.query(q);
+    }
+    return { entries: [] };
+  }
+  /** Force-flush. SQLite writes are synchronous, so this returns once writes complete. */
+  flush() {
+    this.flushSync();
+  }
+  /**
+   * Close the log store and release resources.
+   *
+   * Flushes any pending entries, marks the store as closed, and closes
+   * all registered sinks.
+   */
+  close() {
+    if (this.closed) return;
+    this.flushSync();
+    this.closed = true;
+    if (this.timer) {
+      clearTimeout(this.timer);
+      this.timer = null;
+    }
+    for (const sink of this.sinks) sink.close();
+    this.emitter.removeAllListeners();
+  }
+  flushSync() {
+    if (this.timer) {
+      clearTimeout(this.timer);
+      this.timer = null;
+    }
+    if (this.buffer.length === 0) return;
+    const batch = this.buffer;
+    this.buffer = [];
+    for (const sink of this.sinks) {
+      try {
+        sink.writeBatch(batch);
+      } catch (err) {
+        process.stderr.write(`LogStore sink write failed: ${String(err)}
+`);
+      }
+    }
+  }
+};
+
+// core/src/logging/sinks/types.ts
+var LogStoreDisabledError = class extends Error {
+  constructor() {
+    super("LogStore is disabled (mode=off); query is unavailable");
+    this.name = "LogStoreDisabledError";
+  }
+};
+
+// core/src/logging/sinks/no-op-sink.ts
+var NoOpSink = class {
+  write(_entry) {
+  }
+  writeBatch(_entries) {
+  }
+  query(_q) {
+    throw new LogStoreDisabledError();
+  }
+  close() {
+  }
+};
+
+// core/src/logging/sinks/stdout-sink.ts
+function formatSource(source) {
+  const parts = [source.kind, source.subkind];
+  if (source.instance) parts.push(source.instance);
+  return `[${parts.join(":")}]`;
+}
+function formatTime(iso) {
+  return iso.slice(11, 23);
+}
+var LEVEL_LABEL = {
+  debug: "DEBUG",
+  info: "INFO ",
+  warn: "WARN ",
+  error: "ERROR"
+};
+var StdoutSink = class {
+  format;
+  stream;
+  constructor(opts = {}) {
+    this.stream = opts.stream === "stderr" ? process.stderr : process.stdout;
+    this.format = opts.format ?? (this.stream.isTTY ? "pretty" : "json");
+  }
+  write(entry) {
+    this.stream.write(`${this.render(entry)}
+`);
+  }
+  writeBatch(entries) {
+    for (const e of entries) this.write(e);
+  }
+  close() {
+  }
+  render(entry) {
+    if (this.format === "json") {
+      return JSON.stringify(entry);
+    }
+    const head = `${formatTime(entry.timestamp)}  ${LEVEL_LABEL[entry.level]}  ${formatSource(entry.source)}`;
+    const tail = entry.message;
+    const detail = entry.data ? `
+  > ${JSON.stringify(entry.data)}` : "";
+    const err = entry.error ? `
+  ! ${entry.error.name}: ${entry.error.message}` : "";
+    return `${head}  ${tail}${detail}${err}`;
+  }
+};
+
+// core/src/logging/sanitize.ts
+function normalizeError(value) {
+  if (value === void 0 || value === null) return void 0;
+  if (value instanceof Error) {
+    return {
+      name: value.name,
+      message: value.message,
+      stack: value.stack
+    };
+  }
+  if (typeof value === "string") {
+    return { name: "Error", message: value };
+  }
+  try {
+    return { name: "Error", message: JSON.stringify(value) };
+  } catch {
+    return { name: "Error", message: String(value) };
+  }
+}
+function sanitizeData(value) {
+  if (value === void 0 || value === null) return void 0;
+  const seen = /* @__PURE__ */ new WeakSet();
+  const walk = (v) => {
+    if (v === null || v === void 0) return v;
+    if (typeof v === "bigint") return v.toString();
+    if (typeof v === "function") return "[Function]";
+    if (typeof v === "symbol") return v.toString();
+    if (v instanceof Error) return normalizeError(v);
+    if (typeof v !== "object") return v;
+    if (seen.has(v)) return "[Circular]";
+    seen.add(v);
+    if (Array.isArray(v)) return v.map(walk);
+    const out = {};
+    for (const [k, child] of Object.entries(v)) {
+      out[k] = walk(child);
+    }
+    return out;
+  };
+  const result = walk(value);
+  if (typeof result !== "object" || result === null || Array.isArray(result)) {
+    return { value: result };
+  }
+  return result;
+}
+
+// core/src/logging/create-logger.ts
+var ACTIVE_STORE_KEY = /* @__PURE__ */ Symbol.for("@skaile/workspaces:logging:activeStore");
+var globalStoreSlot = globalThis;
+function registerLogStore(store) {
+  globalStoreSlot[ACTIVE_STORE_KEY] = store;
+}
+function getLogStore() {
+  return globalStoreSlot[ACTIVE_STORE_KEY] ?? null;
+}
+function resetLogStore() {
+  globalStoreSlot[ACTIVE_STORE_KEY] = null;
+}
+function ensureLogStore() {
+  const existing = globalStoreSlot[ACTIVE_STORE_KEY];
+  if (existing) return existing;
+  const fallback = new LogStore({
+    sessionId: "no-session",
+    level: "info",
+    sinks: [new NoOpSink(), new StdoutSink()]
+  });
+  globalStoreSlot[ACTIVE_STORE_KEY] = fallback;
+  return fallback;
+}
+function createLogger(source, opts = {}) {
+  const fallback = opts.fallback !== false;
+  if (!getLogStore() && !fallback) {
+    throw new Error("createLogger: no LogStore registered. Call registerLogStore() first.");
+  }
+  const store = ensureLogStore();
+  return makeLogger(source, store);
+}
+function makeLogger(source, store) {
+  const emit = (level, message, data, err) => {
+    if (!store.isEnabled(level)) return;
+    store.record({
+      source,
+      level,
+      message,
+      data: sanitizeData(data),
+      error: normalizeError(err)
+    });
+  };
+  return {
+    debug(message, data) {
+      emit("debug", message, data);
+    },
+    info(message, data) {
+      emit("info", message, data);
+    },
+    warn(message, data) {
+      emit("warn", message, data);
+    },
+    error(message, err, data) {
+      emit("error", message, data, err);
+    },
+    child(partial) {
+      return makeLogger({ ...source, ...partial }, store);
+    }
+  };
+}
+
+export { LogStore, LogStoreDisabledError, NoOpSink, StdoutSink, createLogger, getLogStore, normalizeError, registerLogStore, resetLogStore, sanitizeData };
+//# sourceMappingURL=chunk-7GOCNYUV.js.map
+//# sourceMappingURL=chunk-7GOCNYUV.js.map

package/dist/chunk-7GOCNYUV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../core/src/logging/log-store.ts","../core/src/logging/sinks/types.ts","../core/src/logging/sinks/no-op-sink.ts","../core/src/logging/sinks/stdout-sink.ts","../core/src/logging/sanitize.ts","../core/src/logging/create-logger.ts"],"names":[],"mappings":"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","file":"chunk-7GOCNYUV.js","sourcesContent":["import { EventEmitter } from \"node:events\";\nimport type {\n  LogEntry,\n  LogLevel,\n  LogQuery,\n  LogQueryResult,\n  LogSource,\n} from \"@skaile/workspaces/types\";\nimport { ulid } from \"ulid\";\nimport type { LogSink } from \"./sinks/types.js\";\n\nexport interface LogStoreOptions {\n  sessionId: string;\n  level: LogLevel;\n  sinks: LogSink[];\n  flushIntervalMs?: number; // default 50\n  flushBatchSize?: number; // default 100\n}\n\nexport interface RecordInput {\n  source: LogSource;\n  level: LogLevel;\n  message: string;\n  data?: Record<string, unknown>;\n  error?: { name: string; message: string; stack?: string };\n}\n\nconst LEVEL_RANK: Record<LogLevel, number> = {\n  debug: 10,\n  info: 20,\n  warn: 30,\n  error: 40,\n};\n\n/**\n * In-memory log buffer with periodic flush to sinks.\n *\n * The LogStore buffers log entries and flushes them to registered sinks\n * either when the buffer reaches a certain size, after a time interval,\n * or when explicitly flushed. Supports subscribing to live log entries.\n *\n * @see {@link LogStoreOptions} for configuration\n * @see {@link LogEntry} for the log entry format\n * @category Logging\n * @since 2.0.0\n */\nexport class LogStore {\n  private sessionId: string;\n  private level: LogLevel;\n  private sinks: LogSink[];\n  private flushIntervalMs: number;\n  private flushBatchSize: number;\n  private buffer: LogEntry[] = [];\n  private timer: NodeJS.Timeout | null = null;\n  private emitter = new EventEmitter();\n  private closed = false;\n\n  constructor(opts: LogStoreOptions) {\n    this.sessionId = opts.sessionId;\n    this.level = opts.level;\n    this.sinks = opts.sinks;\n    this.flushIntervalMs = opts.flushIntervalMs ?? 50;\n    this.flushBatchSize = opts.flushBatchSize ?? 100;\n    this.emitter.setMaxListeners(0);\n  }\n\n  getLevel(): LogLevel {\n    return this.level;\n  }\n\n  setLevel(level: LogLevel): void {\n    this.level = level;\n  }\n\n  /** Append a sink after construction. Used by bridges (e.g. OnLogBridgeSink). */\n  addSink(sink: LogSink): void {\n    this.sinks.push(sink);\n  }\n\n  /** Returns true if the level is enabled. Used by createLogger to short-circuit. */\n  isEnabled(level: LogLevel): boolean {\n    return LEVEL_RANK[level] >= LEVEL_RANK[this.level];\n  }\n\n  record(input: RecordInput): void {\n    if (this.closed) return;\n    if (!this.isEnabled(input.level)) return;\n    const entry: LogEntry = {\n      id: ulid(),\n      timestamp: new Date().toISOString(),\n      sessionId: this.sessionId,\n      source: input.source,\n      level: input.level,\n      message: input.message,\n      data: input.data,\n      error: input.error,\n    };\n    this.emitter.emit(\"entry\", entry);\n    this.buffer.push(entry);\n    if (this.buffer.length >= this.flushBatchSize) {\n      this.flushSync();\n    } else if (this.flushIntervalMs > 0 && this.timer === null) {\n      this.timer = setTimeout(() => this.flushSync(), this.flushIntervalMs);\n    } else if (this.flushIntervalMs === 0) {\n      this.flushSync();\n    }\n  }\n\n  /** Subscribe to live entries. Returns an unsubscribe function. */\n  subscribe(handler: (entry: LogEntry) => void): () => void {\n    this.emitter.on(\"entry\", handler);\n    return () => this.emitter.off(\"entry\", handler);\n  }\n\n  /**\n   * Query stored log entries.\n   *\n   * Queries the first sink that supports querying (typically SQLiteSink).\n   * Returns empty result if no sink supports querying.\n   *\n   * @param q - Query parameters including filters and pagination\n   * @returns Query result with matching entries\n   */\n  query(q: LogQuery): LogQueryResult {\n    for (const sink of this.sinks) {\n      if (sink.query) return sink.query(q);\n    }\n    return { entries: [] };\n  }\n\n  /** Force-flush. SQLite writes are synchronous, so this returns once writes complete. */\n  flush(): void {\n    this.flushSync();\n  }\n\n  /**\n   * Close the log store and release resources.\n   *\n   * Flushes any pending entries, marks the store as closed, and closes\n   * all registered sinks.\n   */\n  close(): void {\n    if (this.closed) return;\n    this.flushSync();\n    this.closed = true;\n    if (this.timer) {\n      clearTimeout(this.timer);\n      this.timer = null;\n    }\n    for (const sink of this.sinks) sink.close();\n    this.emitter.removeAllListeners();\n  }\n\n  private flushSync(): void {\n    if (this.timer) {\n      clearTimeout(this.timer);\n      this.timer = null;\n    }\n    if (this.buffer.length === 0) return;\n    const batch = this.buffer;\n    this.buffer = [];\n    for (const sink of this.sinks) {\n      try {\n        sink.writeBatch(batch);\n      } catch (err) {\n        // Last-resort: log to stderr; never let a sink failure crash the producer.\n        process.stderr.write(`LogStore sink write failed: ${String(err)}\\n`);\n      }\n    }\n  }\n}\n","// LogSink interface lives in @skaile/workspaces/types so consumers can type-check\n// sink instances without depending on core. Runtime errors live here.\nexport type { LogSink } from \"@skaile/workspaces/types\";\n\nexport class LogStoreDisabledError extends Error {\n  constructor() {\n    super(\"LogStore is disabled (mode=off); query is unavailable\");\n    this.name = \"LogStoreDisabledError\";\n  }\n}\n","import type { LogEntry, LogQuery, LogQueryResult } from \"@skaile/workspaces/types\";\nimport { type LogSink, LogStoreDisabledError } from \"./types.js\";\n\nexport class NoOpSink implements LogSink {\n  write(_entry: LogEntry): void {}\n  writeBatch(_entries: LogEntry[]): void {}\n  query(_q: LogQuery): LogQueryResult {\n    throw new LogStoreDisabledError();\n  }\n  close(): void {}\n}\n","import type { LogEntry, LogSource } from \"@skaile/workspaces/types\";\nimport type { LogSink } from \"./types.js\";\n\nexport type StdoutFormat = \"pretty\" | \"json\";\n\n/** Which standard stream the sink writes to. */\nexport type StdoutStream = \"stdout\" | \"stderr\";\n\nexport interface StdoutSinkOptions {\n  format?: StdoutFormat;\n  /**\n   * Standard stream to write to. Default: `\"stdout\"`. Set to `\"stderr\"` for\n   * processes whose stdout is a reserved channel — e.g. a stdio MCP server,\n   * where stdout carries JSON-RPC and any log line would corrupt the protocol.\n   */\n  stream?: StdoutStream;\n}\n\nfunction formatSource(source: LogSource): string {\n  const parts = [source.kind, source.subkind];\n  if (source.instance) parts.push(source.instance);\n  return `[${parts.join(\":\")}]`;\n}\n\nfunction formatTime(iso: string): string {\n  // HH:MM:SS.sss\n  return iso.slice(11, 23);\n}\n\nconst LEVEL_LABEL = {\n  debug: \"DEBUG\",\n  info: \"INFO \",\n  warn: \"WARN \",\n  error: \"ERROR\",\n} as const;\n\nexport class StdoutSink implements LogSink {\n  private format: StdoutFormat;\n  private stream: NodeJS.WriteStream;\n\n  constructor(opts: StdoutSinkOptions = {}) {\n    this.stream = opts.stream === \"stderr\" ? process.stderr : process.stdout;\n    this.format = opts.format ?? (this.stream.isTTY ? \"pretty\" : \"json\");\n  }\n\n  write(entry: LogEntry): void {\n    this.stream.write(`${this.render(entry)}\\n`);\n  }\n\n  writeBatch(entries: LogEntry[]): void {\n    for (const e of entries) this.write(e);\n  }\n\n  close(): void {}\n\n  private render(entry: LogEntry): string {\n    if (this.format === \"json\") {\n      return JSON.stringify(entry);\n    }\n    const head = `${formatTime(entry.timestamp)}  ${LEVEL_LABEL[entry.level]}  ${formatSource(entry.source)}`;\n    const tail = entry.message;\n    const detail = entry.data ? `\\n  > ${JSON.stringify(entry.data)}` : \"\";\n    const err = entry.error ? `\\n  ! ${entry.error.name}: ${entry.error.message}` : \"\";\n    return `${head}  ${tail}${detail}${err}`;\n  }\n}\n","import type { NormalizedError } from \"@skaile/workspaces/types\";\n\nexport function normalizeError(value: unknown): NormalizedError | undefined {\n  if (value === undefined || value === null) return undefined;\n  if (value instanceof Error) {\n    return {\n      name: value.name,\n      message: value.message,\n      stack: value.stack,\n    };\n  }\n  if (typeof value === \"string\") {\n    return { name: \"Error\", message: value };\n  }\n  try {\n    return { name: \"Error\", message: JSON.stringify(value) };\n  } catch {\n    return { name: \"Error\", message: String(value) };\n  }\n}\n\nexport function sanitizeData(value: unknown): Record<string, unknown> | undefined {\n  if (value === undefined || value === null) return undefined;\n  const seen = new WeakSet<object>();\n  const walk = (v: unknown): unknown => {\n    if (v === null || v === undefined) return v;\n    if (typeof v === \"bigint\") return v.toString();\n    if (typeof v === \"function\") return \"[Function]\";\n    if (typeof v === \"symbol\") return v.toString();\n    if (v instanceof Error) return normalizeError(v);\n    if (typeof v !== \"object\") return v;\n    if (seen.has(v as object)) return \"[Circular]\";\n    seen.add(v as object);\n    if (Array.isArray(v)) return v.map(walk);\n    const out: Record<string, unknown> = {};\n    for (const [k, child] of Object.entries(v as Record<string, unknown>)) {\n      out[k] = walk(child);\n    }\n    return out;\n  };\n  const result = walk(value);\n  if (typeof result !== \"object\" || result === null || Array.isArray(result)) {\n    return { value: result };\n  }\n  return result as Record<string, unknown>;\n}\n","import type { Logger, LogSource } from \"@skaile/workspaces/types\";\nimport { LogStore } from \"./log-store.js\";\nimport { normalizeError, sanitizeData } from \"./sanitize.js\";\nimport { NoOpSink } from \"./sinks/no-op-sink.js\";\nimport { StdoutSink } from \"./sinks/stdout-sink.js\";\n\n/**\n * The active LogStore is a process-singleton. It is stored on `globalThis`\n * under a `Symbol.for` key so it survives module duplication — under vitest's\n * `skaile-src` aliasing and the runner's lazy `import(\"@skaile/workspaces/runner\")`,\n * `core/logging` can be evaluated as two distinct module instances. A plain\n * module-scoped `let` would give each instance its own store, so a logger\n * created on one instance would not see a store registered on the other.\n * The `globalThis` slot makes the singleton genuinely process-wide.\n */\nconst ACTIVE_STORE_KEY = Symbol.for(\"@skaile/workspaces:logging:activeStore\");\n\ntype GlobalWithStore = typeof globalThis & {\n  [ACTIVE_STORE_KEY]?: LogStore | null;\n};\n\nconst globalStoreSlot = globalThis as GlobalWithStore;\n\nexport function registerLogStore(store: LogStore): void {\n  globalStoreSlot[ACTIVE_STORE_KEY] = store;\n}\n\nexport function getLogStore(): LogStore | null {\n  return globalStoreSlot[ACTIVE_STORE_KEY] ?? null;\n}\n\nexport function resetLogStore(): void {\n  globalStoreSlot[ACTIVE_STORE_KEY] = null;\n}\n\nexport interface CreateLoggerOptions {\n  /**\n   * When true (default), create + register a lazy off-mode LogStore if none\n   * is registered. When false, throw if no store has been registered.\n   */\n  fallback?: boolean;\n}\n\nfunction ensureLogStore(): LogStore {\n  const existing = globalStoreSlot[ACTIVE_STORE_KEY];\n  if (existing) return existing;\n  // Lazy off-mode fallback: NoOp + Stdout, no SQLite, no sessionId.\n  const fallback = new LogStore({\n    sessionId: \"no-session\",\n    level: \"info\",\n    sinks: [new NoOpSink(), new StdoutSink()],\n  });\n  globalStoreSlot[ACTIVE_STORE_KEY] = fallback;\n  return fallback;\n}\n\n/**\n * Creates a logger for the given source.\n *\n * If no LogStore is registered and fallback is enabled (default), a lazy\n * off-mode fallback store (NoOp + Stdout) is created.\n *\n * @param source - The log source (e.g., { kind: 'agent', name: 'my-agent' })\n * @param opts - Configuration options for logger creation\n * @param opts.fallback - When true (default), creates a fallback store if none registered\n * @returns A logger instance\n * @throws {Error} When no LogStore is registered and fallback is false\n *\n * @example\n * ```typescript\n * const logger = createLogger({ kind: 'agent', name: 'my-agent' });\n * logger.info('Agent started');\n * ```\n */\nexport function createLogger(source: LogSource, opts: CreateLoggerOptions = {}): Logger {\n  const fallback = opts.fallback !== false;\n  if (!getLogStore() && !fallback) {\n    throw new Error(\"createLogger: no LogStore registered. Call registerLogStore() first.\");\n  }\n  const store = ensureLogStore();\n  return makeLogger(source, store);\n}\n\nfunction makeLogger(source: LogSource, store: LogStore): Logger {\n  const emit = (\n    level: \"debug\" | \"info\" | \"warn\" | \"error\",\n    message: string,\n    data?: object,\n    err?: unknown,\n  ) => {\n    if (!store.isEnabled(level)) return;\n    store.record({\n      source,\n      level,\n      message,\n      data: sanitizeData(data),\n      error: normalizeError(err),\n    });\n  };\n  return {\n    debug(message, data) {\n      emit(\"debug\", message, data);\n    },\n    info(message, data) {\n      emit(\"info\", message, data);\n    },\n    warn(message, data) {\n      emit(\"warn\", message, data);\n    },\n    error(message, err, data) {\n      emit(\"error\", message, data, err);\n    },\n    child(partial) {\n      return makeLogger({ ...source, ...partial }, store);\n    },\n  };\n}\n"]}

package/dist/{chunk-KY5NY7LB.js → chunk-BCTU4TN7.js}

@@ -1,5 +1,5 @@
-import { findAiAssetsRoot } from './chunk-XCBG2KDC.js';
-import { parseSkillRequirements, validateRequirements, buildRequiresPreamble, parseSkillFrontmatter } from './chunk-GXC3TYMQ.js';
+import { findAiAssetsRoot } from './chunk-BK3WL3QK.js';
+import { parseSkillRequirements, validateRequirements, buildRequiresPreamble, parseSkillFrontmatter } from './chunk-CZZRDYT4.js';
 import { okJson, err, ok } from './chunk-X5YPJV4N.js';
 import fs from 'fs/promises';
 import path from 'path';
@@ -64,7 +64,7 @@ async function scanSkills(aiAssetsRoot, domainFilter) {
 }
 async function skillList(projectDir, domain) {
   try {
-    const aiAssetsRoot = findAiAssetsRoot(projectDir);
+    const aiAssetsRoot = await findAiAssetsRoot(projectDir);
     if (!aiAssetsRoot) return okJson([]);
     const skills = await scanSkills(aiAssetsRoot, domain);
     return okJson(
@@ -84,7 +84,7 @@ async function skillList(projectDir, domain) {
 }
 async function skillListDomains(projectDir) {
   try {
-    const aiAssetsRoot = findAiAssetsRoot(projectDir);
+    const aiAssetsRoot = await findAiAssetsRoot(projectDir);
     if (!aiAssetsRoot) return okJson([]);
     const entries = await fs.readdir(aiAssetsRoot, { withFileTypes: true });
     const domains = entries.filter((e) => e.isDirectory()).map((e) => ({ name: e.name, path: path.join(aiAssetsRoot, e.name) }));
@@ -95,7 +95,7 @@ async function skillListDomains(projectDir) {
 }
 async function skillShow(projectDir, skillId) {
   try {
-    const aiAssetsRoot = findAiAssetsRoot(projectDir);
+    const aiAssetsRoot = await findAiAssetsRoot(projectDir);
     if (!aiAssetsRoot) return err(`Skill not found: ${skillId}`);
     const skills = await scanSkills(aiAssetsRoot, void 0);
     const skill = skills.find((s) => s.id === skillId);
@@ -108,7 +108,7 @@ async function skillShow(projectDir, skillId) {
 }
 async function skillSearch(projectDir, query) {
   try {
-    const aiAssetsRoot = findAiAssetsRoot(projectDir);
+    const aiAssetsRoot = await findAiAssetsRoot(projectDir);
     if (!aiAssetsRoot) return okJson([]);
     const skills = await scanSkills(aiAssetsRoot, void 0);
     const q = query.toLowerCase();
@@ -132,14 +132,14 @@ async function skillSearch(projectDir, query) {
 }
 async function skillCheckRequirements(projectDir, skillId, targetDir) {
   try {
-    const aiAssetsRoot = findAiAssetsRoot(projectDir);
+    const aiAssetsRoot = await findAiAssetsRoot(projectDir);
     if (!aiAssetsRoot) return err(`Skill not found: ${skillId}`);
     const skills = await scanSkills(aiAssetsRoot, void 0);
     const skill = skills.find((s) => s.id === skillId);
     if (!skill) return err(`Skill not found: ${skillId}`);
     const content = await fs.readFile(skill.path, "utf-8");
     const requirements = parseSkillRequirements(content);
-    const report = validateRequirements(skillId, requirements, targetDir);
+    const report = await validateRequirements(skillId, requirements, targetDir);
     return okJson(report);
   } catch (e) {
     return err(e instanceof Error ? e.message : String(e));
@@ -147,7 +147,7 @@ async function skillCheckRequirements(projectDir, skillId, targetDir) {
 }
 async function skillGetPreamble(projectDir, skillId) {
   try {
-    const aiAssetsRoot = findAiAssetsRoot(projectDir);
+    const aiAssetsRoot = await findAiAssetsRoot(projectDir);
     if (!aiAssetsRoot) return err(`Skill not found: ${skillId}`);
     const skills = await scanSkills(aiAssetsRoot, void 0);
     const skill = skills.find((s) => s.id === skillId);
@@ -162,5 +162,5 @@ async function skillGetPreamble(projectDir, skillId) {
 }
 
 export { skillCheckRequirements, skillGetPreamble, skillList, skillListDomains, skillSearch, skillShow };
-//# sourceMappingURL=chunk-KY5NY7LB.js.map
-//# sourceMappingURL=chunk-KY5NY7LB.js.map
+//# sourceMappingURL=chunk-BCTU4TN7.js.map
+//# sourceMappingURL=chunk-BCTU4TN7.js.map

package/dist/chunk-BCTU4TN7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../workspace-plugin/src/tools/skills.ts"],"names":[],"mappings":"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","file":"chunk-BCTU4TN7.js","sourcesContent":["// src/tools/skills.ts\n\nimport type { Dirent } from \"node:fs\";\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport {\n  buildRequiresPreamble,\n  parseSkillFrontmatter,\n  parseSkillRequirements,\n  validateRequirements,\n} from \"@skaile/workspaces/resolver\";\nimport type { ToolResult } from \"../types.js\";\nimport { err, ok, okJson } from \"../types.js\";\nimport { findAiAssetsRoot } from \"../utils/ai-assets.js\";\n\ninterface SkillEntry {\n  id: string;\n  name: string;\n  description: string;\n  source?: string;\n  version?: string;\n  keywords?: string[];\n  path: string;\n  domain: string;\n}\n\nasync function walkForSkillMd(dir: string, domain: string, acc: SkillEntry[]): Promise<void> {\n  let entries: Dirent<string>[];\n  try {\n    entries = await fs.readdir(dir, { withFileTypes: true });\n  } catch {\n    return;\n  }\n\n  // Check if this directory contains a SKILL.md\n  const hasSkillMd = entries.some((e) => e.isFile() && e.name === \"SKILL.md\");\n  if (hasSkillMd) {\n    const skillMdPath = path.join(dir, \"SKILL.md\");\n    try {\n      const content = await fs.readFile(skillMdPath, \"utf-8\");\n      const fm = parseSkillFrontmatter(content);\n      const name = typeof fm.name === \"string\" ? fm.name : path.basename(dir);\n      const description = typeof fm.description === \"string\" ? fm.description : \"\";\n      const source = typeof fm.source === \"string\" ? fm.source : undefined;\n      const version = typeof fm.version === \"string\" ? fm.version : undefined;\n      const keywords = Array.isArray(fm.keywords) ? (fm.keywords as string[]) : undefined;\n      acc.push({\n        id: path.basename(dir),\n        name,\n        description,\n        source,\n        version,\n        keywords,\n        path: skillMdPath,\n        domain,\n      });\n    } catch {\n      // skip unreadable files\n    }\n    return; // don't recurse inside a skill directory\n  }\n\n  // Recurse into subdirectories\n  for (const entry of entries) {\n    if (entry.isDirectory()) {\n      await walkForSkillMd(path.join(dir, entry.name), domain, acc);\n    }\n  }\n}\n\nasync function scanSkills(aiAssetsRoot: string, domainFilter?: string): Promise<SkillEntry[]> {\n  let domains: string[];\n  try {\n    const entries = await fs.readdir(aiAssetsRoot, { withFileTypes: true });\n    domains = entries\n      .filter((e) => e.isDirectory())\n      .map((e) => e.name)\n      .filter((name) => !domainFilter || name === domainFilter);\n  } catch {\n    return [];\n  }\n\n  const acc: SkillEntry[] = [];\n  for (const domain of domains) {\n    const skillsDir = path.join(aiAssetsRoot, domain, \"skills\");\n    try {\n      await fs.access(skillsDir);\n    } catch {\n      continue; // no skills/ dir in this domain\n    }\n    await walkForSkillMd(skillsDir, domain, acc);\n  }\n  return acc;\n}\n\n// ── Exported tool functions ────────────────────────────────────────────────────\n\n/**\n * List all skills in the `ai-assets` catalog, optionally filtered by domain.\n *\n * Walks every `<domain>/skills/` directory under the `ai-assets` root looking\n * for `SKILL.md` files.  Returns a JSON array of skill summaries\n * `{ id, name, description, source, version, keywords, domain }`.\n *\n * @param projectDir - Absolute path to the skaile project root.\n * @param domain     - Optional domain name filter (e.g. `\"skaile-development\"`).\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function skillList(\n  projectDir: string,\n  domain: string | undefined,\n): Promise<ToolResult> {\n  try {\n    const aiAssetsRoot = await findAiAssetsRoot(projectDir);\n    if (!aiAssetsRoot) return okJson([]);\n    const skills = await scanSkills(aiAssetsRoot, domain);\n    return okJson(\n      skills.map((s) => ({\n        id: s.id,\n        name: s.name,\n        description: s.description,\n        source: s.source,\n        version: s.version,\n        keywords: s.keywords,\n        domain: s.domain,\n      })),\n    );\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n\n/**\n * List all skill domains — the top-level directories under `ai-assets` that\n * contain a `skills/` subdirectory.\n *\n * Returns a JSON array of `{ name, path }` objects.\n *\n * @param projectDir - Absolute path to the skaile project root.\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function skillListDomains(projectDir: string): Promise<ToolResult> {\n  try {\n    const aiAssetsRoot = await findAiAssetsRoot(projectDir);\n    if (!aiAssetsRoot) return okJson([]);\n    const entries = await fs.readdir(aiAssetsRoot, { withFileTypes: true });\n    const domains = entries\n      .filter((e) => e.isDirectory())\n      .map((e) => ({ name: e.name, path: path.join(aiAssetsRoot, e.name) }));\n    return okJson(domains);\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n\n/**\n * Show the full `SKILL.md` content for a skill.\n *\n * @param projectDir - Absolute path to the skaile project root.\n * @param skillId    - Skill ID (directory name) as returned by {@link skillList}.\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function skillShow(projectDir: string, skillId: string): Promise<ToolResult> {\n  try {\n    const aiAssetsRoot = await findAiAssetsRoot(projectDir);\n    if (!aiAssetsRoot) return err(`Skill not found: ${skillId}`);\n    const skills = await scanSkills(aiAssetsRoot, undefined);\n    const skill = skills.find((s) => s.id === skillId);\n    if (!skill) return err(`Skill not found: ${skillId}`);\n    const content = await fs.readFile(skill.path, \"utf-8\");\n    return ok(content);\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n\n/**\n * Search skills by name, description, ID, or keywords.\n *\n * Case-insensitive substring match against all text fields in every skill\n * entry.  Returns the same summary shape as {@link skillList}.\n *\n * @param projectDir - Absolute path to the skaile project root.\n * @param query      - Search string.\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function skillSearch(projectDir: string, query: string): Promise<ToolResult> {\n  try {\n    const aiAssetsRoot = await findAiAssetsRoot(projectDir);\n    if (!aiAssetsRoot) return okJson([]);\n    const skills = await scanSkills(aiAssetsRoot, undefined);\n    const q = query.toLowerCase();\n    const matched = skills.filter(\n      (s) =>\n        s.name.toLowerCase().includes(q) ||\n        s.description.toLowerCase().includes(q) ||\n        s.id.toLowerCase().includes(q) ||\n        (s.keywords ?? []).some((k) => k.toLowerCase().includes(q)),\n    );\n    return okJson(\n      matched.map((s) => ({\n        id: s.id,\n        name: s.name,\n        description: s.description,\n        source: s.source,\n        version: s.version,\n        keywords: s.keywords,\n        domain: s.domain,\n      })),\n    );\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n\n/**\n * Validate that all prerequisites declared in a skill's `SKILL.md` are\n * satisfied in `targetDir`.\n *\n * Uses `@skaile/workspaces/resolver` to parse the `REQUIRES` / `READS` / `WRITES`\n * DSL and run the requirement checks against the filesystem.  Returns a\n * validation report as JSON.\n *\n * @param projectDir - Absolute path to the skaile project root (for skill lookup).\n * @param skillId    - Skill ID as returned by {@link skillList}.\n * @param targetDir  - Directory to validate against (typically the user's project).\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function skillCheckRequirements(\n  projectDir: string,\n  skillId: string,\n  targetDir: string,\n): Promise<ToolResult> {\n  try {\n    const aiAssetsRoot = await findAiAssetsRoot(projectDir);\n    if (!aiAssetsRoot) return err(`Skill not found: ${skillId}`);\n    const skills = await scanSkills(aiAssetsRoot, undefined);\n    const skill = skills.find((s) => s.id === skillId);\n    if (!skill) return err(`Skill not found: ${skillId}`);\n    const content = await fs.readFile(skill.path, \"utf-8\");\n\n    const requirements = parseSkillRequirements(content);\n    const report = await validateRequirements(skillId, requirements, targetDir);\n    return okJson(report);\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n\n/**\n * Get the formatted `REQUIRES`/`INPUT`/`READS`/`WRITES` DSL preamble for a skill.\n *\n * Uses `@skaile/workspaces/resolver` to build the requirements preamble that can be\n * prepended to the skill prompt for injection into the agent's context.\n * Returns `\"(no requirements declared)\"` when the skill has no requirements.\n *\n * @param projectDir - Absolute path to the skaile project root.\n * @param skillId    - Skill ID as returned by {@link skillList}.\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function skillGetPreamble(projectDir: string, skillId: string): Promise<ToolResult> {\n  try {\n    const aiAssetsRoot = await findAiAssetsRoot(projectDir);\n    if (!aiAssetsRoot) return err(`Skill not found: ${skillId}`);\n    const skills = await scanSkills(aiAssetsRoot, undefined);\n    const skill = skills.find((s) => s.id === skillId);\n    if (!skill) return err(`Skill not found: ${skillId}`);\n    const content = await fs.readFile(skill.path, \"utf-8\");\n\n    const requirements = parseSkillRequirements(content);\n    const preamble = buildRequiresPreamble(requirements, skillId);\n    return ok(preamble || \"(no requirements declared)\");\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n"]}

package/dist/chunk-BEAIJRVF.js

@@ -0,0 +1,159 @@
+import { tryWithFsDeadline, withFsDeadline, fsDeadlineMs } from './chunk-DYMWJAL4.js';
+import { createLogger } from './chunk-7GOCNYUV.js';
+import { stat, mkdir, cp, writeFile, rm } from 'fs/promises';
+import { resolve, sep, join } from 'path';
+
+var TREE_OP_DEADLINE_FACTOR = 4;
+var AI_ASSETS_WALK_LEVELS = 6;
+var deployerLogger;
+function log() {
+  deployerLogger ??= createLogger({ kind: "runner", subkind: "catalog-deployer" });
+  return deployerLogger;
+}
+var DEFAULT_WORKSPACE_MOUNT_DIR = "/skaile/workspace";
+var WORKSPACE_MOUNT_ENV_VAR = "SKAILE_WORKSPACE_MOUNT_DIR";
+function workspaceMountDirs() {
+  const raw = process.env[WORKSPACE_MOUNT_ENV_VAR];
+  if (raw === void 0) return [DEFAULT_WORKSPACE_MOUNT_DIR];
+  return raw.split(",").map((segment) => segment.trim()).filter((segment) => segment.length > 0).map((segment) => resolve(segment));
+}
+function isUnderWorkspaceMount(candidate, mountDirs = workspaceMountDirs()) {
+  const target = resolve(candidate);
+  return mountDirs.some((dir) => {
+    const root = resolve(dir);
+    return target === root || target.startsWith(root + sep);
+  });
+}
+async function findAiAssetsRoot(startDir, opts) {
+  const mountDirs = opts?.mountDirs ?? workspaceMountDirs();
+  const levels = opts?.levels ?? AI_ASSETS_WALK_LEVELS;
+  let dir = resolve(startDir);
+  const refused = [];
+  for (let i = 0; i < levels; i++) {
+    const candidate = join(dir, "ai-assets");
+    if (isUnderWorkspaceMount(candidate, mountDirs)) {
+      refused.push(candidate);
+    } else {
+      const isDir = await tryWithFsDeadline(
+        `stat ${candidate}`,
+        async () => (await stat(candidate)).isDirectory(),
+        false
+      );
+      if (isDir) {
+        if (refused.length > 0) warnRefused(refused, mountDirs);
+        return candidate;
+      }
+    }
+    const parent = resolve(dir, "..");
+    if (parent === dir) break;
+    dir = parent;
+  }
+  if (refused.length > 0) warnRefused(refused, mountDirs);
+  return null;
+}
+function warnRefused(refused, mountDirs) {
+  log().warn(
+    "findAiAssetsRoot refused candidates under a workspace mount \u2014 deploying skills from a network mount can stall the session",
+    { refused, mountDirs }
+  );
+}
+async function deployCatalogEntry(entry, options) {
+  const { assetsRoot, skillsDir, context } = options;
+  if (entry.kind !== "skill") {
+    return { success: false, error: `Cannot deploy ${entry.kind} directly \u2014 only skills` };
+  }
+  const sourcePath = join(assetsRoot, entry.source_path);
+  const skillMdPath = join(sourcePath, "SKILL.md");
+  const hasSkillMd = await tryWithFsDeadline(
+    `stat ${skillMdPath}`,
+    async () => {
+      await stat(skillMdPath);
+      return true;
+    },
+    false
+  );
+  if (!hasSkillMd) {
+    return { success: false, error: `SKILL.md not found at ${skillMdPath}` };
+  }
+  const destDir = join(skillsDir, entry.name);
+  try {
+    await withFsDeadline(`mkdir ${destDir}`, () => mkdir(destDir, { recursive: true }));
+    await withFsDeadline(
+      `cp ${sourcePath} -> ${destDir}`,
+      () => cp(sourcePath, destDir, { recursive: true }),
+      fsDeadlineMs() * TREE_OP_DEADLINE_FACTOR
+    );
+    const contextPath = join(destDir, "CONTEXT.md");
+    if (context) {
+      await withFsDeadline(
+        `write ${contextPath}`,
+        () => writeFile(contextPath, `# Additional Context
+
+${context}
+`, "utf8")
+      );
+    } else {
+      await withFsDeadline(`rm ${contextPath}`, () => rm(contextPath, { force: true }));
+    }
+  } catch (err) {
+    return { success: false, error: err instanceof Error ? err.message : String(err) };
+  }
+  return { success: true };
+}
+async function undeployCatalogEntry(name, skillsDir) {
+  const destDir = join(skillsDir, name);
+  const exists = await tryWithFsDeadline(
+    `stat ${destDir}`,
+    async () => {
+      await stat(destDir);
+      return true;
+    },
+    false
+  );
+  if (!exists) return false;
+  await withFsDeadline(
+    `rm -r ${destDir}`,
+    () => rm(destDir, { recursive: true, force: true }),
+    fsDeadlineMs() * TREE_OP_DEADLINE_FACTOR
+  );
+  return true;
+}
+async function deployAll(entries, options) {
+  const result = { deployed: [], skipped: [], errors: [] };
+  for (const entry of entries) {
+    if (entry.kind !== "skill") {
+      result.skipped.push(entry.id);
+      continue;
+    }
+    const r = await deployCatalogEntry(entry, options);
+    if (r.success) {
+      result.deployed.push(entry.id);
+    } else {
+      result.errors.push(`${entry.id}: ${r.error}`);
+    }
+  }
+  return result;
+}
+function resolveFlowSkills(flow, allEntries) {
+  const skillsByName = /* @__PURE__ */ new Map();
+  for (const e of allEntries) {
+    if (e.kind === "skill") skillsByName.set(e.name, e);
+  }
+  const required = [];
+  const optional = [];
+  const missing = [];
+  for (const name of flow.required_skills ?? []) {
+    const entry = skillsByName.get(name);
+    if (entry) required.push(entry);
+    else missing.push(name);
+  }
+  for (const name of flow.optional_skills ?? []) {
+    const entry = skillsByName.get(name);
+    if (entry) optional.push(entry);
+  }
+  return { required, optional, missing };
+}
+
+export { WORKSPACE_MOUNT_ENV_VAR, deployAll, deployCatalogEntry, findAiAssetsRoot, isUnderWorkspaceMount, resolveFlowSkills, undeployCatalogEntry, workspaceMountDirs };
+//# sourceMappingURL=chunk-BEAIJRVF.js.map
+//# sourceMappingURL=chunk-BEAIJRVF.js.map