@skaile/workspaces 0.8.5

package/dist/bridge/src/types.d.ts

@@ -0,0 +1,564 @@
+import { EventEmitter } from "node:events";
+import type { Capability, CredentialMint, RenderInvokedEvent, TokenUsage } from "@skaile/workspaces/types";
+import type { TelemetryProvider, Trace, Span } from "@skaile/workspaces/telemetry";
+import type { ModelEntry } from "./models.js";
+/**
+ * Minimal LLM tool descriptor used by the capability dispatch path. Mirrors
+ * the runner's `LLMTool` shape so drivers can consume registry output without
+ * importing `@skaile/workspaces/runner` (which would create a circular dep).
+ *
+ * @category Capabilities
+ * @since 2.0.0
+ * @docLink packages/bridge/concepts#bridge-capability-tool
+ */
+export interface BridgeCapabilityTool {
+    /** Capability name; used as the LLM-visible tool name. */
+    name: string;
+    /** Human/LLM-readable description. */
+    description: string;
+    /** JSON Schema for the tool's input parameters. */
+    parameters: Record<string, unknown>;
+}
+/**
+ * Render-cap event emission callback used by the bridge when the LLM invokes
+ * a capability that carries a `render` spec. The runner provides the actual
+ * sink (transport.send / sendEvent); the bridge only emits.
+ *
+ * @category Capabilities
+ * @since 2.0.0
+ * @docLink packages/bridge/concepts#bridge-render-emit
+ */
+export type BridgeRenderEmit = (event: RenderInvokedEvent) => void;
+/**
+ * Text-event emission callback for render-capability fallbacks. When a
+ * `RenderCapability` carries `render.fallback` and the LLM invokes it, the
+ * bridge substitutes `{{prop}}` placeholders (top-level keys of `props`,
+ * optional dotted-path traversal `{{user.name}}`) and pushes the rendered
+ * string through this callback so clients without a render layer still see
+ * a textual representation. No-op when `fallback` is absent.
+ *
+ * @category Capabilities
+ * @since 2.0.0
+ * @docLink packages/bridge/concepts#bridge-text-emit
+ */
+export type BridgeTextEmit = (text: string) => void;
+/**
+ * Bundle of capability dispatch hooks. Registered into the driver via
+ * `AgentConfig.capabilities`; the driver routes registered LLM tool calls
+ * back into `invoke()` instead of using its native dispatch path.
+ *
+ * The runner constructs this from a `CapabilityRegistry` instance and threads
+ * it through `createAgentSession()`. Drivers that don't yet implement
+ * capability dispatch ignore the field — legacy v1 paths stay intact.
+ *
+ * @category Capabilities
+ * @since 2.0.0
+ * @docLink packages/bridge/concepts#bridge-capability-hooks
+ */
+export interface BridgeCapabilityHooks {
+    /** Build the LLM tool descriptor list from the registry. Called per turn so registration changes take effect. */
+    composeTools(): BridgeCapabilityTool[];
+    /** Resolve a wire-format Capability descriptor by name. Used by the bridge to inspect `fireAndForget` / `render`. */
+    resolve(name: string): Capability | null;
+    /** Validate input + dispatch through the registry. Logging is wired by the registry. */
+    invoke(name: string, input: unknown): Promise<unknown>;
+    /** Emit a render-invoked event. The runner forwards via the WebSocket transport. */
+    emitRender?: BridgeRenderEmit;
+    /** Emit a text fallback for render capabilities with `render.fallback`. */
+    emitText?: BridgeTextEmit;
+    /** Session id passed through to the runner's per-handler logger. */
+    sessionId: string;
+}
+/**
+ * Static metadata for a registered agent driver backend.
+ *
+ * Returned by {@link listDrivers} and exposed on every {@link AgentDriver} instance
+ * via `driverInfo`.
+ *
+ * @docLink packages/bridge/concepts#driver-info
+ */
+export interface DriverInfo {
+    /** Stable machine identifier used to look up the driver in the registry (e.g. `"omp"`, `"claude-sdk"`). */
+    id: string;
+    /** Human-readable display name shown in UIs and logs. */
+    name: string;
+    /** `true` when the driver can target any LLM provider; `false` for Anthropic-only drivers. */
+    modelAgnostic: boolean;
+    /**
+     * `true` when the driver supports mid-stream abort via `abort()` without killing the process.
+     * Drivers that return `false` can only be stopped via `kill()`.
+     */
+    supportsInBandAbort: boolean;
+}
+/**
+ * Codex-specific tuning options passed through `DriverOptions.codex`.
+ *
+ * @remarks These are forwarded verbatim to the Codex driver and have no effect on other drivers.
+ * @docLink packages/bridge/concepts#codex-driver-options
+ */
+export interface CodexDriverOptions {
+    /** Controls whether Codex may auto-apply edits without user approval. */
+    approvalPolicy?: "never" | "on-request" | "on-failure" | "untrusted";
+    /** Filesystem sandbox level for the Codex process. */
+    sandboxMode?: "read-only" | "workspace-write" | "danger-full-access";
+    /** Reasoning budget passed to the model. */
+    reasoningEffort?: "minimal" | "low" | "medium" | "high" | "xhigh";
+    /** When `true`, the Codex sandbox is allowed to make outbound network requests. */
+    networkAccessEnabled?: boolean;
+    /** Extra directories made accessible to the Codex sandbox in addition to `cwd`. */
+    additionalDirectories?: string[];
+}
+/**
+ * Driver-specific configuration bag.
+ *
+ * Fields are keyed by driver ID so that callers can pass driver-specific options
+ * through the common {@link AgentConfig} without breaking other drivers.
+ *
+ * @docLink packages/bridge/concepts#driver-options
+ */
+export interface DriverOptions {
+    /** Codex-specific options. Ignored by all other drivers. */
+    codex?: CodexDriverOptions;
+}
+/**
+ * Configuration passed to a driver when it is created via {@link createDriver}.
+ *
+ * All fields are shared across drivers; driver-specific behaviour is documented
+ * per field. Fields that are silently ignored by a driver are marked accordingly.
+ *
+ * @docLink packages/bridge/concepts#agent-config
+ */
+export interface AgentConfig {
+    /** Absolute path to the working directory the agent operates in. */
+    cwd: string;
+    /**
+     * LLM provider name (e.g. `"anthropic"`, `"openai"`, `"google"`).
+     * Combined with `model` as `provider/model` for omp's `--model` flag.
+     * Ignored by claude-sdk (always Anthropic).
+     */
+    provider?: string;
+    /**
+     * LLM model identifier (e.g. `"claude-sonnet-4-5"`, `"gpt-4o"`).
+     * For omp: passed as `--model [provider/]model`.
+     * For claude-sdk: passed as the `model` query option.
+     */
+    model?: string;
+    /**
+     * Provider API keys keyed by provider name (e.g. `{ anthropic: "sk-..." }`).
+     * Drivers inject the relevant key into the environment or SDK options.
+     */
+    apiKeys?: Record<string, string>;
+    /**
+     * Additional environment variables merged into the child process environment.
+     * For omp: merged with `process.env` before spawn. For claude-sdk: accessed
+     * via `env.ANTHROPIC_API_KEY` as an alternative to `apiKeys.anthropic`.
+     */
+    env?: Record<string, string>;
+    /** Inline system prompt — written to .omp/system.md and passed via --append-system-prompt (omp driver) */
+    systemPrompt?: string;
+    /** Path to project .omp/ directory (PI_CODING_AGENT_DIR for omp driver) */
+    agentDir?: string;
+    /** SSH key path — injected as GIT_SSH_COMMAND */
+    sshKeyPath?: string;
+    /** Pre-assign a UUID as the session ID for a new session (claude-sdk: passed as sessionId option) */
+    sessionId?: string;
+    /** Resume this specific past session by UUID instead of starting fresh (claude-sdk: passed as resume option) */
+    resumeSessionId?: string;
+    /** Maximum agentic turns per query (claude-sdk: passed as maxTurns option) */
+    maxTurns?: number;
+    /** Agent name — selects a deployed sub-agent definition as the main agent identity.
+     *  claude-sdk: passed as `agent` option to query() → reads .claude/agents/<name>.md natively.
+     *  omp: ignored (omp uses agentDir/PI_CODING_AGENT_DIR instead). */
+    agentName?: string;
+    /** In-process SDK MCP servers for custom tool injection (Claude SDK only, ignored by other drivers) */
+    mcpServers?: Record<string, unknown>;
+    /** Tool restrictions from agent.yaml — applied to the main agent session */
+    tools?: {
+        /** Tool names that the agent is allowed to invoke. An empty array means no restriction. */
+        allowed?: string[];
+        /** Tool names that the agent is explicitly forbidden from invoking. */
+        denied?: string[];
+    };
+    /** Thinking mode for Claude models: adaptive (Claude decides), enabled (always think), disabled (no thinking). */
+    thinking?: "adaptive" | "enabled" | "disabled";
+    /** Reasoning effort level for Claude models. */
+    effort?: "low" | "medium" | "high" | "max";
+    /** Driver-specific configuration bag. */
+    driverOptions?: DriverOptions;
+    /**
+     * Protocol v2 capability dispatch hooks. When present, the driver uses the
+     * registry as the source of LLM tool definitions and routes invocations
+     * through `capabilities.invoke()`. Absent → legacy v1 path (existing
+     * mcpServers / native dispatch).
+     *
+     * @since 2.0.0
+     */
+    capabilities?: BridgeCapabilityHooks;
+    /**
+     * The platform's `AIProviderConfig.id` for the AI credential currently
+     * provisioned into this driver. The runner reads this off `AgentConfig`
+     * during 401 mediation and passes it as `configId` in
+     * `request_access_token { kind: 'ai-credentials' }`. The driver itself
+     * does not consume this field — only the runner uses it.
+     *
+     * Set by the platform agent-gateway in `ConfigureCommandV2` for mediated
+     * sessions. Standalone runners (CLI / forge / Claude plugin) leave it
+     * undefined; the runner falls back to surfacing the auth error to the
+     * user without mediating.
+     *
+     * Spec: `_devlog/specs/2026-05-07-unified-credential-mediation.md`
+     * § "Wire `aiProviderConfigId` end-to-end".
+     *
+     * @since 3.3.0
+     */
+    aiProviderConfigId?: string;
+    /**
+     * Optional callback invoked by the driver when the underlying agent
+     * surfaces an `authentication_error`. In Protocol v3 the runner mediates
+     * the refresh via the `host.refresh_credential` capability and returns a
+     * typed {@link CredentialMint}. The driver inspects the discriminator:
+     *
+     *   - `mint.ok === true`: a fresh credential is now provisioned. The
+     *     driver re-attempts the in-flight prompt once.
+     *   - `mint.ok === false`: refresh failed (`code` carries a stable reason
+     *     such as `revoked`, `not-configured`, `provider-error`,
+     *     `backend-error`). The driver surfaces the original `AuthError` to
+     *     the caller.
+     *
+     * `args.configId` carries the platform `AIProviderConfig.id` the driver
+     * was provisioned with (mirrors {@link AgentConfig.aiProviderConfigId}).
+     * The runner uses it to scope the refresh to the correct AI credential.
+     *
+     * When omitted, the driver throws `AuthError` immediately as before
+     * (standalone CLI / forge mode — there is no platform mediator to ask).
+     *
+     * Centralising auth-retry inside the driver means every consumer of
+     * `driver.prompt(...)` (serve handler, compaction orchestrator, flow
+     * orchestrator, …) gets self-healing for free — there is no per-call-site
+     * wrapping.
+     *
+     * Spec: `_devlog/specs/2026-05-10-deterministic-session-bootstrap.md`
+     * § "host.refresh_credential capability".
+     *
+     * @since 3.4.0
+     */
+    onAuthError?: (args: {
+        configId: string;
+    }) => Promise<CredentialMint>;
+}
+/**
+ * A single message in an agent conversation.
+ *
+ * Emitted as part of {@link AgentEvent} variants (`message_start`, `message_update`, `message_end`).
+ *
+ * @docLink packages/bridge/concepts#agent-message
+ */
+export interface AgentMessage {
+    /** Originator of the message. */
+    role: "user" | "assistant" | "tool";
+    /** Message body — either a plain string or a list of typed content blocks. */
+    content: string | ContentBlock[];
+    /** Tool invocations made by the assistant in this message. */
+    toolCalls?: ToolCall[];
+    /** For `role === "tool"`: the name of the tool whose result this message carries. */
+    toolName?: string;
+    /** For `role === "tool"`: `true` when the tool returned an error. */
+    isError?: boolean;
+    /** Optional structured payload for tool results. */
+    data?: unknown;
+}
+/**
+ * A typed block within an {@link AgentMessage}'s content array.
+ *
+ * Mirrors the Anthropic content block schema but is driver-agnostic.
+ *
+ * @docLink packages/bridge/concepts#content-block
+ */
+export interface ContentBlock {
+    /** Block discriminant. */
+    type: "text" | "tool_use" | "tool_result" | "thinking";
+    /** Present for `text` and `thinking` blocks. */
+    text?: string;
+    /** Tool use / tool result correlation ID. */
+    id?: string;
+    /** Tool name (present on `tool_use` blocks). */
+    name?: string;
+    /** Tool input arguments (present on `tool_use` blocks). */
+    input?: any;
+    /** Serialised tool result content (present on `tool_result` blocks). */
+    content?: string;
+}
+/**
+ * A single tool invocation made by the agent within a message.
+ *
+ * @docLink packages/bridge/concepts#tool-call
+ */
+export interface ToolCall {
+    /** Correlation ID used to match the call with its result. */
+    id: string;
+    /** Name of the tool being invoked. */
+    name: string;
+    /** Arguments passed to the tool. */
+    input: any;
+}
+/**
+ * Error classification for agent failures.
+ *
+ * Used to determine whether a failure is retryable and to surface actionable
+ * hints to the user. See `bridge/CLAUDE.md` for the full category-to-behaviour matrix.
+ *
+ * @see AgentError
+ * @docLink packages/bridge/concepts#error-category
+ */
+export type ErrorCategory = "auth" | "rate_limit" | "model" | "network" | "config" | "process" | "validation" | "unknown";
+/**
+ * Structured error payload emitted inside the `error` {@link AgentEvent}.
+ *
+ * Consumers should inspect `retryable` before deciding to surface a retry button,
+ * and `hint` to provide an actionable message to the user.
+ *
+ * @docLink packages/bridge/concepts#agent-error
+ */
+export interface AgentError {
+    /** Human-readable error description. */
+    message: string;
+    /** Coarse failure classification used for retry logic and telemetry. */
+    category: ErrorCategory;
+    /** HTTP status code if the error originated from an API response. */
+    statusCode?: number;
+    /** `true` when the caller may safely retry the same operation. */
+    retryable: boolean;
+    /** Short actionable advice suitable for display in the UI. */
+    hint?: string;
+}
+/**
+ * Metadata for a slash command exposed by the active agent runtime.
+ *
+ * @docLink packages/bridge/concepts#slash-command-info
+ */
+export interface SlashCommandInfo {
+    /** Command name without the leading slash (e.g. `"compact"`). */
+    name: string;
+    /** One-line description shown in command pickers. */
+    description: string;
+    /** Placeholder text describing what argument the command expects. */
+    argumentHint?: string;
+}
+/**
+ * Discriminated union of all events emitted by a driver on the `'agent-event'` channel.
+ *
+ * @remarks
+ * Consumers listen via `driver.on('agent-event', (event: AgentEvent) => ...)`.
+ * The `[k: string]: any` index signature on most variants allows drivers to attach
+ * driver-specific fields (e.g. `_textDelta`) without breaking the union.
+ *
+ * @docLink packages/bridge/concepts#agent-event
+ */
+export type AgentEvent = {
+    type: "message_start";
+    message: AgentMessage;
+    [k: string]: any;
+} | {
+    type: "message_update";
+    message: AgentMessage;
+    [k: string]: any;
+} | {
+    type: "message_end";
+    message: AgentMessage;
+    [k: string]: any;
+} | {
+    type: "turn_end";
+    toolResults?: AgentMessage[];
+    [k: string]: any;
+} | {
+    type: "agent_end";
+    [k: string]: any;
+} | {
+    type: "result";
+    subtype: string;
+    summary?: string;
+    costUsd?: number;
+    /** Per-turn token usage when the driver tracks it. Added in 3.1.0. */
+    tokens?: TokenUsage;
+    errors?: string[];
+    [k: string]: any;
+} | {
+    type: "error";
+    error: string;
+    detail?: AgentError;
+    fatal?: boolean;
+    [k: string]: any;
+} | {
+    type: "tool_call";
+    name?: string;
+    tool?: {
+        name: string;
+    };
+    [k: string]: any;
+} | {
+    type: "tool_execution_end";
+    toolName?: string;
+    [k: string]: any;
+} | {
+    type: "commands_available";
+    commands: SlashCommandInfo[];
+} | {
+    type: "session_info";
+    driverSessionId: string;
+    sessionFile?: string;
+} | {
+    type: "ui_render";
+    [k: string]: any;
+} | {
+    type: "ui_render_update";
+    [k: string]: any;
+} | {
+    type: "ui_clear";
+    [k: string]: any;
+} | {
+    type: "resume_failed";
+    resumeSessionId: string;
+    reason: "signature_mismatch" | "model_mismatch" | "jsonl_lost";
+    [k: string]: any;
+};
+/**
+ * Abstract base class for agent driver backends.
+ *
+ * Wraps an LLM coding agent behind a single `prompt()` interface.
+ * All drivers emit `'agent-event'` with {@link AgentEvent} payloads.
+ *
+ * @remarks
+ * Subclasses must implement `start`, `prompt`, `abort`, `kill`, and `isRunning`.
+ * Implementations should never emit an event name other than `'agent-event'` as
+ * the public streaming channel — internal events (`'ready'`, `'exit'`, etc.) are
+ * driver-private.
+ *
+ * @example
+ * ```ts
+ * const driver = createDriver('omp', config);
+ * driver.on('agent-event', (event) => console.log(event.type));
+ * await driver.start();
+ * await driver.prompt('Refactor the auth module');
+ * driver.kill();
+ * ```
+ *
+ * @docLink packages/bridge/concepts#agent-driver
+ */
+export declare abstract class AgentDriver extends EventEmitter {
+    /** Static metadata describing this driver's capabilities. */
+    abstract readonly driverInfo: DriverInfo;
+    /**
+     * Initialises the driver backend — spawns the child process (omp) or loads
+     * the SDK module (claude-sdk). Resolves when the backend is ready to accept
+     * prompts. Idempotent: calling `start()` on an already-running driver is a no-op.
+     *
+     * @throws {Error} When the backend binary is missing or the SDK cannot be loaded.
+     */
+    abstract start(): Promise<void>;
+    /**
+     * Sends a user message to the agent and resolves when the agent's turn completes
+     * (i.e. after the `agent_end` event has been emitted).
+     *
+     * @param message - Plain-text user prompt to send to the agent.
+     * @throws {Error} When the driver is not running or the underlying backend reports a fatal error.
+     */
+    abstract prompt(message: string): Promise<void>;
+    /**
+     * Sends an in-band abort signal to the agent, requesting it to stop the current
+     * turn without terminating the process. The driver remains usable after `abort()`.
+     *
+     * @remarks Only meaningful when `driverInfo.supportsInBandAbort` is `true`.
+     *   For other drivers, prefer `kill()` followed by creating a new driver instance.
+     */
+    abstract abort(): Promise<void>;
+    /**
+     * Terminates the agent backend immediately (SIGTERM for subprocess drivers,
+     * `close()` for in-process drivers). The driver instance must not be reused
+     * after `kill()`.
+     */
+    abstract kill(): void;
+    /** `true` when the backend is alive and able to accept new prompts. */
+    abstract get isRunning(): boolean;
+    /** Optional provider-native session/thread identifier for resume support. */
+    get runtimeSessionId(): string | undefined;
+    /** Slash commands discovered from the agent runtime. Override in drivers that support introspection. */
+    getSlashCommands(): SlashCommandInfo[];
+    /**
+     * Live-update driver configuration. The new values take effect on the next
+     * prompt() call. Only model/thinking/effort are reconfigurable mid-session.
+     *
+     * Subclasses that store config locally should override this to apply the
+     * patch to their own config field. The base implementation is a no-op.
+     */
+    reconfigure(patch: Partial<Pick<AgentConfig, "model" | "thinking" | "effort">>): void;
+    /**
+     * Returns the model identifier currently configured on this driver.
+     * Subclasses that store config locally should override this.
+     */
+    getModel(): string | undefined;
+    /**
+     * Returns the token usage from the most recent completed turn.
+     * Returns `null` if usage data is unavailable (e.g. driver doesn't track it).
+     *
+     * Widened in 3.1.0 to return the full `TokenUsage` shape (input / output /
+     * cache-read / cache-creation / reasoning). All fields are optional so
+     * drivers can populate just what their provider reports. Existing callers
+     * that read only `inputTokens` / `outputTokens` keep working — those fields
+     * are still present and carry the same semantics as before.
+     */
+    getTokenUsage(): TokenUsage | null;
+    /**
+     * Returns the model's context window size in tokens.
+     * Returns `null` if unknown.
+     */
+    getContextWindow(): number | null;
+    /**
+     * Returns the list of models available to this driver without starting a session.
+     * Drivers that can enumerate their own models override this method.
+     * Returns an empty array by default.
+     */
+    listModels(): Promise<ModelEntry[]>;
+    /**
+     * Closes the current conversation session and prepares for a fresh start.
+     * The next `prompt()` call will begin a new session without prior history.
+     * The driver remains usable after `resetSession()`.
+     */
+    abstract resetSession(): Promise<void>;
+    protected _telemetry?: TelemetryProvider;
+    protected _activeTrace?: Trace;
+    protected _activeTurnSpan?: Span;
+    private _turnStartTime?;
+    /**
+     * Attach a telemetry provider and active trace to this driver.
+     * Called by the runner after creating the driver but before start().
+     */
+    setTelemetry(provider: TelemetryProvider, trace: Trace): void;
+    /**
+     * Begin a turn span. Called by the runner before prompt().
+     * Pass a parent span (e.g. the turn span from the orchestrator) for nesting.
+     * Returns the span so the runner can annotate it further.
+     */
+    beginTurnSpan(parent?: Trace | Span, attrs?: Record<string, string | number | boolean>): Span | undefined;
+    /**
+     * End the current turn span with generation data.
+     * Called by the runner after agent_end. Model and provider are passed
+     * explicitly — the driver base class does not access config directly.
+     */
+    endTurnSpan(result?: {
+        model?: string;
+        provider?: string;
+        inputTokens?: number;
+        outputTokens?: number;
+        stopReason?: string;
+        error?: string;
+    }): void;
+}
+/**
+ * Factory function signature registered in the driver registry.
+ *
+ * @param config - Configuration for the new driver instance.
+ * @returns A freshly constructed (not yet started) {@link AgentDriver}.
+ * @docLink packages/bridge/concepts#driver-factory
+ */
+export type DriverFactory = (config: AgentConfig) => AgentDriver;
+//# sourceMappingURL=types.d.ts.map

package/dist/bridge/src/types.d.ts.map

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

package/dist/bridge/src/validation.d.ts

@@ -0,0 +1,27 @@
+/** Provider API key validation — hits each provider's models endpoint to verify the key works. */
+/**
+ * Result of an API key validation check performed by {@link validateApiKey}.
+ *
+ * @docLink packages/bridge/api-reference#validation
+ */
+export interface ValidationResult {
+    /** `true` when the API key was accepted by the provider's models endpoint. */
+    ok: boolean;
+    /** Human-readable error description when `ok` is `false`. */
+    error?: string;
+}
+/**
+ * Validate an API key by sending a lightweight GET request to the provider's models endpoint.
+ *
+ * Returns `{ ok: true }` when the provider accepts the key (HTTP 2xx). Returns
+ * `{ ok: false, error }` on 401/403 (invalid key), other HTTP errors, network failures,
+ * or unsupported providers. Requests time out after 8 seconds.
+ *
+ * @param provider - Provider name matching a key in the internal `PROVIDER_CONFIGS` map
+ *   (e.g. `"anthropic"`, `"openai"`, `"google"`).
+ * @param key - API key to validate.
+ * @returns Validation result with optional error description.
+ * @docLink packages/bridge/api-reference#validation
+ */
+export declare function validateApiKey(provider: string, key: string): Promise<ValidationResult>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/bridge/src/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../bridge/src/validation.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAElG;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,EAAE,EAAE,OAAO,CAAC;IACZ,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAoDD;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8B7F"}

package/dist/chunk-2M3XTMOL.js

@@ -0,0 +1,23 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+// cli/src/paths.ts
+var __ownDir = path.dirname(fileURLToPath(import.meta.url));
+function findMonorepoRoot(from) {
+  let dir = from;
+  for (let i = 0; i < 6; i++) {
+    if (fs.existsSync(path.join(dir, "ai-assets"))) return dir;
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+var MONOREPO_ROOT = findMonorepoRoot(__ownDir);
+var AI_RESOURCES = MONOREPO_ROOT !== null ? path.join(MONOREPO_ROOT, "ai-assets") : path.join(os.homedir(), ".skaile", "libraries");
+
+export { AI_RESOURCES, MONOREPO_ROOT };
+//# sourceMappingURL=chunk-2M3XTMOL.js.map
+//# sourceMappingURL=chunk-2M3XTMOL.js.map

package/dist/chunk-2M3XTMOL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../cli/src/paths.ts"],"names":[],"mappings":";;;;;;AAKA,IAAM,WAAW,IAAA,CAAK,OAAA,CAAQ,aAAA,CAAc,MAAA,CAAA,IAAA,CAAY,GAAG,CAAC,CAAA;AAQ5D,SAAS,iBAAiB,IAAA,EAA6B;AACrD,EAAA,IAAI,GAAA,GAAM,IAAA;AACV,EAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,CAAA,EAAG,CAAA,EAAA,EAAK;AAC1B,IAAA,IAAI,EAAA,CAAG,WAAW,IAAA,CAAK,IAAA,CAAK,KAAK,WAAW,CAAC,GAAG,OAAO,GAAA;AACvD,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,OAAA,CAAQ,GAAG,CAAA;AAC/B,IAAA,IAAI,WAAW,GAAA,EAAK;AACpB,IAAA,GAAA,GAAM,MAAA;AAAA,EACR;AACA,EAAA,OAAO,IAAA;AACT;AAYO,IAAM,aAAA,GAA+B,iBAAiB,QAAQ;AAgB9D,IAAM,YAAA,GACX,aAAA,KAAkB,IAAA,GACd,IAAA,CAAK,KAAK,aAAA,EAAe,WAAW,CAAA,GACpC,IAAA,CAAK,IAAA,CAAK,EAAA,CAAG,OAAA,EAAQ,EAAG,WAAW,WAAW","file":"chunk-2M3XTMOL.js","sourcesContent":["import fs from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst __ownDir = path.dirname(fileURLToPath(import.meta.url));\n\n/**\n * Walk up from `from` looking for the monorepo marker (`ai-assets/`). Returns\n * the matching directory or `null` when none is found within six levels — the\n * latter is the typical case when `@skaile/workspace-cli` has been installed\n * via `npm i -g` without a skaile-dev workspace context.\n */\nfunction findMonorepoRoot(from: string): string | null {\n  let dir = from;\n  for (let i = 0; i < 6; i++) {\n    if (fs.existsSync(path.join(dir, \"ai-assets\"))) return dir;\n    const parent = path.dirname(dir);\n    if (parent === dir) break;\n    dir = parent;\n  }\n  return null;\n}\n\n/**\n * Absolute path to the monorepo root, or `null` when the CLI is running\n * outside the skaile-dev workspace (typical for `npm i -g` installs).\n *\n * Consumers that only make sense inside the workspace (e.g.\n * `skaile serve --compile-test`) MUST check for `null` and report a\n * \"monorepo-only feature\" error before proceeding.\n *\n * @docLink cli/dev-guide#paths\n */\nexport const MONOREPO_ROOT: string | null = findMonorepoRoot(__ownDir);\n\n/**\n * Default content root used by `findSkills`, `loadAllFlows`, and the dynamic\n * shell-completion resolvers.\n *\n * - **Inside the monorepo**: `<MONOREPO_ROOT>/ai-assets`.\n * - **Outside the monorepo** (e.g. `npm i -g @skaile/workspace-cli`): falls\n *   back to `~/.skaile/libraries/` — the user-library directory managed by\n *   `skaile library add`. If no libraries are registered the directory either\n *   does not exist or is empty, and consumers (which all `fs.existsSync` first)\n *   degrade to \"no skills / flows discovered\" with a hint to run\n *   `skaile library add <git-url>`.\n *\n * @docLink cli/dev-guide#paths\n */\nexport const AI_RESOURCES: string =\n  MONOREPO_ROOT !== null\n    ? path.join(MONOREPO_ROOT, \"ai-assets\")\n    : path.join(os.homedir(), \".skaile\", \"libraries\");\n"]}