@skaile/workspaces 0.8.5

package/dist/tui/src/index.d.ts

@@ -0,0 +1,4 @@
+export { startRepl, type ReplOptions } from "./repl.js";
+export { TuiTelemetryProvider, formatTelemetryEntry } from "./telemetry.js";
+export type { ReplSessionHandle } from "./repl-session.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tui/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../tui/src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/tui/src/repl-renderer.d.ts

@@ -0,0 +1,31 @@
+import type { OutputLine } from "@skaile/workspaces";
+import type { TelemetryLogEntry } from "./telemetry.js";
+/**
+ * Render a single OutputLine to an ANSI-colored string for terminal display.
+ *
+ * Each `OutputLine` variant is mapped to a distinct colour: user input (cyan/bold),
+ * agent text (plain), tool calls (blue italic), questions (yellow), errors (red),
+ * status/system messages (dim italic), subagent lifecycle (blue/green italic), and
+ * separator lines (dim dashes). Returns an empty string for unrecognised variants.
+ *
+ * @param line - The typed output line to render.
+ * @returns ANSI-coloured string ready for terminal output.
+ *
+ * @docLink packages/tui/concepts#repl-renderer
+ */
+export declare function renderLine(line: OutputLine): string;
+/**
+ * Render a telemetry log entry to an ANSI string, or null to suppress.
+ *
+ * Formats `generation` entries with model name, token counts, cost, and duration;
+ * `span_end` entries for `tool_call` and `agent_turn` kinds; and `trace_start` /
+ * `trace_end` lifecycle entries. All output is styled dim for visual de-emphasis.
+ * Returns `null` for entry kinds that should not appear in the log panel.
+ *
+ * @param entry - The structured telemetry event to render.
+ * @returns Dim ANSI string, or `null` if the entry should be suppressed.
+ *
+ * @docLink packages/tui/concepts#repl-renderer
+ */
+export declare function renderLog(entry: TelemetryLogEntry): string | null;
+//# sourceMappingURL=repl-renderer.d.ts.map

package/dist/tui/src/repl-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl-renderer.d.ts","sourceRoot":"","sources":["../../../tui/src/repl-renderer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CA0BnD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAuBjE"}

package/dist/tui/src/repl-session.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Slim event bridge: maps AgentDriver events to rendered console lines.
+ * No React, no ink, no UI state — just event → string → callback.
+ */
+import type { AgentSession } from "@skaile/workspaces/runner";
+import type { SessionState } from "@skaile/workspaces";
+import type { TelemetryLogEntry } from "./telemetry.js";
+/**
+ * Handle returned by {@link createReplSession} for controlling an active REPL session.
+ *
+ * `state` reflects the current lifecycle state (`idle`, `active`, or `stopped`).
+ * Call `send(text)` to forward a user message to the agent driver; the state
+ * transitions to `active` until the driver emits `agent_end`. Call `stop()` to
+ * terminate the driver and dispose of the underlying agent session.
+ *
+ * @docLink packages/tui/concepts#repl-session
+ */
+export interface ReplSessionHandle {
+    readonly state: SessionState;
+    send(text: string): void;
+    stop(): void;
+}
+/**
+ * Options for {@link createReplSession}.
+ *
+ * @param session - The agent session returned by `createAgentSession`.
+ * @param onLine - Callback invoked with an ANSI-rendered string for each output line.
+ * @param onLog - Callback invoked with a log string for each telemetry event (if verbose).
+ * @param onStateChange - Callback invoked whenever the session state changes.
+ *
+ * @docLink packages/tui/concepts#repl-session
+ */
+export interface CreateReplSessionOpts {
+    session: AgentSession;
+    onLine?: (line: string) => void;
+    onLog?: (line: string) => void;
+    onStateChange?: (state: SessionState) => void;
+}
+/**
+ * Create a slim event bridge that maps `AgentEvent` stream to rendered console lines.
+ *
+ * Subscribes to `agent-event` on the session driver and converts each event type
+ * (`message_update`, `tool_call`, `error`, `agent_end`, `turn_end`, `subagent`) to
+ * an `OutputLine`, renders it via {@link renderLine}, and forwards the string to
+ * `opts.onLine`. Text content is buffered internally and flushed line-by-line as
+ * newlines arrive. Returns a {@link ReplSessionHandle} for sending messages and
+ * stopping the session.
+ *
+ * @param opts - Session, output callbacks, and state-change hook.
+ * @returns Handle for sending messages and observing session state.
+ *
+ * @docLink packages/tui/concepts#repl-session
+ */
+export declare function createReplSession(opts: CreateReplSessionOpts): ReplSessionHandle;
+/**
+ * Create a telemetry sink that pipes {@link TelemetryLogEntry} events to the log callback.
+ *
+ * Wraps {@link renderLog} so that only displayable entries (generation, span_end for
+ * tool/turn, trace lifecycle) are forwarded. Entries that `renderLog` returns `null`
+ * for are silently suppressed. The returned function is used in `startRepl` to drain
+ * buffered telemetry and to wire up live forwarding during the session.
+ *
+ * @param onLog - Callback invoked with an ANSI-rendered log string.
+ * @returns A function that accepts a `TelemetryLogEntry` and routes it to `onLog`.
+ *
+ * @docLink packages/tui/concepts#repl-session
+ */
+export declare function createTelemetrySink(onLog: (line: string) => void): (entry: TelemetryLogEntry) => void;
+//# sourceMappingURL=repl-session.d.ts.map

package/dist/tui/src/repl-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl-session.d.ts","sourceRoot":"","sources":["../../../tui/src/repl-session.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,IAAI,IAAI,CAAC;CACd;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;CAC/C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,iBAAiB,CAiGhF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC5B,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAKpC"}

package/dist/tui/src/repl.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Simple @clack-based agent REPL.
+ * No React, no ink, no alt-screen — just a scrolling terminal.
+ *
+ * Design: clack's text() blocks until user submits, so agent output
+ * flows naturally between prompts — no readline interleaving issues.
+ * Loop: await text() → send → await idle → loop
+ */
+/**
+ * Options for {@link startRepl}.
+ *
+ * @param projectDir - Absolute path to the project root. Used to locate the agent dir, settings, and skill count.
+ * @param cwd - Working directory passed to the agent process. Defaults to `projectDir`.
+ * @param driver - Agent driver override (`"omp"` or `"claude-sdk"`). Falls back to settings resolution.
+ * @param model - Model name passed to the agent driver.
+ * @param provider - Provider name passed to the agent driver.
+ * @param resume - When `true`, load the last session ID from `.skaile/last_session` and resume it.
+ * @param resumeSessionId - Explicit session ID to resume. Takes precedence over `resume`.
+ * @param verbose - When `true`, show telemetry log lines inline between prompts. Default: `false`.
+ *
+ * @docLink packages/tui/concepts#start-repl
+ */
+export interface ReplOptions {
+    projectDir: string;
+    cwd?: string;
+    driver?: string;
+    model?: string;
+    provider?: string;
+    resume?: boolean;
+    resumeSessionId?: string;
+    /** When true, show telemetry log lines inline. Default: false. */
+    verbose?: boolean;
+}
+/**
+ * Start the scrolling REPL for an interactive agent conversation.
+ *
+ * Initialises the agent session (including OMP extension injection when the driver is `omp`),
+ * prints a banner with project metadata, then enters a `@clack/prompts` input loop.
+ * Each iteration awaits user input, forwards it to the agent via {@link createReplSession},
+ * and blocks until the agent signals `idle` or `stopped`. Slash commands (`/help`, `/log`,
+ * `/quit`) are handled before the message reaches the agent.
+ *
+ * @param opts - Configuration for the REPL session.
+ * @returns Resolves when the session ends (user quit or fatal error).
+ *
+ * @docLink packages/tui/concepts#start-repl
+ */
+export declare function startRepl(opts: ReplOptions): Promise<void>;
+//# sourceMappingURL=repl.d.ts.map

package/dist/tui/src/repl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../../tui/src/repl.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmDH;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAyKhE"}

package/dist/tui/src/telemetry.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Local telemetry sink that emits structured events to the TUI log panel.
+ *
+ * Implements `TelemetryProvider` so it can be injected into `createAgentSession`
+ * without any HTTP or OpenTelemetry overhead. Instead of exporting spans over a
+ * network, it converts each lifecycle event (trace start/end, span start/end,
+ * generation, metric) into a {@link TelemetryLogEntry} and forwards it via the
+ * `onEvent` callback. The REPL uses this to optionally display timing and token
+ * cost inline when `--verbose` is active.
+ *
+ * @docLink packages/tui/concepts#tui-telemetry-provider
+ */
+import type { Attributes, GenerationEvent, Span, SpanKind, SpanOptions, SpanResult, TelemetryProvider, Trace, TraceOptions } from "@skaile/workspaces/telemetry";
+/**
+ * A structured telemetry event emitted by {@link TuiTelemetryProvider}.
+ *
+ * Discriminated union over `kind`. The TUI renders a subset of these (generation,
+ * span_end for tool/turn, trace lifecycle) and suppresses the rest. Used as input
+ * to {@link formatTelemetryEntry} and {@link renderLog}.
+ *
+ * @docLink packages/tui/concepts#tui-telemetry-provider
+ */
+export type TelemetryLogEntry = {
+    kind: "trace_start";
+    traceId: string;
+    name: string;
+    traceKind: string;
+} | {
+    kind: "trace_end";
+    traceId: string;
+    status: string;
+    durationMs: number;
+} | {
+    kind: "span_start";
+    spanId: string;
+    name: string;
+    spanKind: SpanKind;
+} | {
+    kind: "span_end";
+    spanId: string;
+    name: string;
+    spanKind: SpanKind;
+    status: string;
+    durationMs: number;
+} | {
+    kind: "generation";
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    costUsd: number;
+    durationMs: number;
+} | {
+    kind: "metric";
+    name: string;
+    value: number;
+};
+export declare class TuiTelemetryProvider implements TelemetryProvider {
+    private readonly onEvent;
+    private readonly spans;
+    private readonly traces;
+    constructor(onEvent: (entry: TelemetryLogEntry) => void);
+    startTrace(opts: TraceOptions): Trace;
+    endTrace(trace: Trace, result?: SpanResult): void;
+    startSpan(parent: Trace | Span, opts: SpanOptions): Span;
+    endSpan(span: Span, result?: SpanResult): void;
+    addEvent(_span: Span, _name: string, _attrs?: Attributes): void;
+    logGeneration(_span: Span, generation: GenerationEvent): void;
+    recordMetric(name: string, value: number, _tags?: Record<string, string>): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/**
+ * Format a {@link TelemetryLogEntry} into a human-readable string for the log panel.
+ *
+ * Produces plain (no ANSI) strings suitable for structured logging or non-terminal
+ * output. The format mirrors {@link renderLog} but without colour codes: generation
+ * entries include model, token counts, cost, and duration; span_end entries for
+ * `tool_call` and `agent_turn` kinds include name, status, and duration; trace
+ * lifecycle entries include name and elapsed time. Returns `null` for entry kinds
+ * that should not be displayed.
+ *
+ * @param entry - The structured telemetry event to format.
+ * @returns Human-readable string, or `null` if the entry should be suppressed.
+ *
+ * @docLink packages/tui/concepts#tui-telemetry-provider
+ */
+export declare function formatTelemetryEntry(entry: TelemetryLogEntry): string | null;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/tui/src/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../tui/src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,KAAK,EACL,YAAY,EACb,MAAM,8BAA8B,CAAC;AAItC;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,GACxE;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAcpD,qBAAa,oBAAqB,YAAW,iBAAiB;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0D;gBAErE,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI;IAIvD,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,KAAK;IAUrC,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI;IAcjD,SAAS,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI;IAiBxD,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI;IAgB9C,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI;IAI/D,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI;IAW7D,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIzE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IACtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIhC;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAuB5E"}

package/dist/types/index.js

@@ -0,0 +1,4 @@
+export { MENTION_GROUPS, PROTOCOL_VERSION, PROTOCOL_VERSION_STRING, QUICK_REACTIONS, formatVersion, isRenderCapability, isUserInvokable, parseVersion } from '../chunk-O5AE4QDX.js';
+import '../chunk-NSBPE2FW.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/types/manifests.js

@@ -0,0 +1,4 @@
+export { ANTHROPIC_FULL_ID_PATTERN, ANTHROPIC_MODEL_ALIASES, AgentComposeItemSchema, AgentManifestSchema, ArtifactRefSchema, AssetKindSchema, AssetKindValues, BaseFrontmatterSchema, BindingSchema, BindingValues, CommonMetadataSchema, ConnectorManifestSchema, ContractManifestSchema, FieldSchema, FilePrerequisiteSchema, McpServerManifestSchema, ModelIdSchema, MountManifestSchema, PersonaManifestSchema, PlaceholderSchema, PlaceholderTypeSchema, PresetItemSchema, PresetManifestSchema, PromptManifestSchema, RulesetManifestSchema, SkillManifestSchema, UserInputSchema, normalizeAnthropicModel, validateAgent, validateByKind, validateConnector, validateContract, validateManifest, validateMcpServer, validateMount, validatePersona, validatePreset, validatePrompt, validateRuleset, validateSkill } from '../chunk-Z3RER6YZ.js';
+import '../chunk-NSBPE2FW.js';
+//# sourceMappingURL=manifests.js.map
+//# sourceMappingURL=manifests.js.map

package/dist/types/manifests.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"manifests.js"}