@skaile/workspaces 0.8.5

package/dist/sdk/src/factory.d.ts

@@ -0,0 +1,19 @@
+/**
+ * createAgentSession() — universal factory for agent sessions.
+ *
+ * Handles workspace preparation, skaile.yaml writing, runtime selection,
+ * startup, and cleanup registration. Returns a ready-to-use {@link AgentSession}.
+ *
+ * For multi-session managers (forge-tui) or bots (forge-mattermost) that need
+ * custom session subclasses, use LocalRuntime directly:
+ *
+ *   const runtime = new LocalRuntime();
+ *   await runtime.start({ projectDir: dir, agentDir });
+ *   const session = new MySession(id, name, runtime);
+ *
+ * @docLink packages/sdk/concepts#create-agent-session
+ */
+import { AgentSession } from "./agent-session.js";
+import type { CreateAgentSessionOptions } from "./types.js";
+export declare function createAgentSession(opts?: CreateAgentSessionOptions): Promise<AgentSession>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/sdk/src/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../sdk/src/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D,wBAAsB,kBAAkB,CACtC,IAAI,GAAE,yBAA8B,GACnC,OAAO,CAAC,YAAY,CAAC,CA6BvB"}

package/dist/sdk/src/flow/index.d.ts

@@ -0,0 +1,2 @@
+export * from "@skaile/workspaces/base-assets/connectors/flow/engine";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/src/flow/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../sdk/src/flow/index.ts"],"names":[],"mappings":"AAAA,cAAc,uDAAuD,CAAC"}

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

@@ -0,0 +1,7 @@
+export { AgentSession, MAX_OUTPUT_LINES } from "./agent-session.js";
+export { LocalRuntime } from "./local-runtime.js";
+export { InProcessTransport } from "./transport.js";
+export { createAgentSession } from "./factory.js";
+export { prepareWorkspace, writeSkaileYaml } from "./workspace.js";
+export type { SessionState, OutputLine, SessionMode, CreateAgentSessionOptions, MountConfig, ConnectorConfig, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../sdk/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACnE,YAAY,EACV,YAAY,EACZ,UAAU,EACV,WAAW,EACX,yBAAyB,EACzB,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/sdk/src/local-runtime.d.ts

@@ -0,0 +1,51 @@
+/**
+ * LocalRuntime — IAgentRuntime implementation that runs the agent in the same process.
+ *
+ * Mirror image of AgentClient: same interface, no WebSocket.
+ * Uses InProcessTransport + startAgentServer() internally.
+ *
+ * Usage:
+ *   const runtime = new LocalRuntime();
+ *   runtime.onEvent(e => console.log(e));
+ *   await runtime.start({ projectDir: "/path/to/workspace" });
+ *   await runtime.prompt("Hello");
+ *   await runtime.dispose();
+ *
+ * @docLink packages/sdk/concepts#local-runtime
+ */
+import type { AgentEvent, IAgentRuntime } from "@skaile/workspaces/types";
+/**
+ * Options passed to {@link LocalRuntime.start}.
+ *
+ * `projectDir` is the only required field — it points to the workspace directory
+ * containing `skaile.yaml`. All other fields override the manifest's agent configuration.
+ *
+ * @docLink packages/sdk/concepts#local-runtime
+ */
+export interface LocalRuntimeStartOptions {
+    projectDir: string;
+    agentDir?: string;
+    driver?: string;
+    model?: string;
+    provider?: string;
+    onLog?: (line: string) => void;
+}
+export declare class LocalRuntime implements Omit<IAgentRuntime, "start" | "configure"> {
+    private readonly transport;
+    private readonly handlers;
+    private started;
+    constructor();
+    /**
+     * Start the agent server. Resolves when the runner is wired and ready
+     * to accept commands. Must be called before prompt() / reply().
+     */
+    start(opts: LocalRuntimeStartOptions): Promise<void>;
+    prompt(message: string): Promise<void>;
+    reply(answer: string): Promise<void>;
+    abort(): Promise<void>;
+    dispose(): Promise<void>;
+    onEvent(handler: (e: AgentEvent) => void): void;
+    offEvent(handler: (e: AgentEvent) => void): void;
+    get isRunning(): boolean;
+}
+//# sourceMappingURL=local-runtime.d.ts.map

package/dist/sdk/src/local-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-runtime.d.ts","sourceRoot":"","sources":["../../../sdk/src/local-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG1E;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,qBAAa,YAAa,YAAW,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,WAAW,CAAC;IAC7E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAC/D,OAAO,CAAC,OAAO,CAAS;;IAQxB;;;OAGG;IACG,KAAK,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAcpD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAI/C,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAIhD,IAAI,SAAS,IAAI,OAAO,CAEvB;CACF"}

package/dist/sdk/src/resolver/index.d.ts

@@ -0,0 +1,2 @@
+export * from "@skaile/workspaces/resolver";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/src/resolver/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../sdk/src/resolver/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC"}

package/dist/sdk/src/runner/index.d.ts

@@ -0,0 +1,2 @@
+export * from "@skaile/workspaces/runner";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/src/runner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../sdk/src/runner/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC"}

package/dist/sdk/src/session/index.d.ts

@@ -0,0 +1,2 @@
+export * from "@skaile/workspaces/session";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/src/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../sdk/src/session/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC"}

package/dist/sdk/src/store/index.d.ts

@@ -0,0 +1,2 @@
+export * from "@skaile/workspaces/store";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/src/store/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../sdk/src/store/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC"}

package/dist/sdk/src/telemetry/index.d.ts

@@ -0,0 +1,2 @@
+export * from "@skaile/workspaces/telemetry";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/src/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../sdk/src/telemetry/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC"}

package/dist/sdk/src/transport/index.d.ts

@@ -0,0 +1,2 @@
+export * from "@skaile/workspaces/transport";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/src/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../sdk/src/transport/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC"}

package/dist/sdk/src/transport/ws/client.d.ts

@@ -0,0 +1,2 @@
+export * from "@skaile/workspaces/transport/ws/client";
+//# sourceMappingURL=client.d.ts.map

package/dist/sdk/src/transport/ws/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../sdk/src/transport/ws/client.ts"],"names":[],"mappings":"AAAA,cAAc,wCAAwC,CAAC"}

package/dist/sdk/src/transport/ws/index.d.ts

@@ -0,0 +1,2 @@
+export * from "@skaile/workspaces/transport/ws";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/src/transport/ws/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../sdk/src/transport/ws/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC"}

package/dist/sdk/src/transport/ws/server.d.ts

@@ -0,0 +1,2 @@
+export * from "@skaile/workspaces/transport/ws/server";
+//# sourceMappingURL=server.d.ts.map

package/dist/sdk/src/transport/ws/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../../sdk/src/transport/ws/server.ts"],"names":[],"mappings":"AAAA,cAAc,wCAAwC,CAAC"}

package/dist/sdk/src/transport.d.ts

@@ -0,0 +1,31 @@
+/**
+ * InProcessTransport — ServerTransport that runs entirely in-process.
+ *
+ * Used internally by {@link LocalRuntime}. Also exported for consumers building
+ * custom integrations that need direct transport access without WebSocket overhead.
+ *
+ * Runner side (startAgentServer):
+ *   onCommand(handler) — registers the runner's command handler
+ *   send(event)        — delivers AgentEvents to onEvent subscribers
+ *
+ * Application side:
+ *   inject(command)    — sends a command to the agent (deferred to avoid re-entrancy)
+ *   onEvent(handler)   — subscribes to AgentEvents; returns unsubscribe fn
+ *
+ * @docLink packages/sdk/concepts#in-process-transport
+ */
+import type { AgentCommand, AgentEvent, ServerTransport } from "@skaile/workspaces/types";
+export declare class InProcessTransport implements ServerTransport {
+    private readonly commandHandlers;
+    private readonly eventHandlers;
+    send(event: AgentEvent): void;
+    onCommand(handler: (cmd: AgentCommand) => void): () => void;
+    onConnect(_handler: () => void): () => void;
+    onDisconnect(_handler: () => void): () => void;
+    get connected(): boolean;
+    /** Send a command into the agent runner. Deferred to avoid re-entrancy. */
+    inject(command: AgentCommand): void;
+    /** Subscribe to AgentEvents. Returns an unsubscribe function. */
+    onEvent(handler: (event: AgentEvent) => void): () => void;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/sdk/src/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../sdk/src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE1F,qBAAa,kBAAmB,YAAW,eAAe;IACxD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0C;IAC1E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0C;IAIxE,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAI7B,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI;IAK3D,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAI3C,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAI9C,IAAI,SAAS,IAAI,OAAO,CAEvB;IAID,2EAA2E;IAC3E,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAMnC,iEAAiE;IACjE,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;CAI1D"}

package/dist/sdk/src/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "@skaile/workspaces/types";
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../sdk/src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC"}

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

@@ -0,0 +1,140 @@
+/**
+ * Lifecycle state of an agent session.
+ *
+ * Transitions follow the state machine: `starting → idle ↔ active ↔ waiting → stopped`.
+ *
+ * @docLink packages/sdk/concepts#core-types
+ */
+export type SessionState = "starting" | "idle" | "active" | "waiting" | "stopped";
+/**
+ * A single rendered line of session output.
+ *
+ * Discriminated union so UI layers (ink, HTML, plain text) handle each case explicitly.
+ * Text content accumulates in-place during streaming; a new `text` line is opened for
+ * each agent response turn and sealed when the next non-text event arrives.
+ *
+ * @docLink packages/sdk/concepts#core-types
+ */
+export type OutputLine = {
+    type: "user";
+    content: string;
+} | {
+    type: "text";
+    content: string;
+} | {
+    type: "tool";
+    name: string;
+} | {
+    type: "question";
+    text: string;
+} | {
+    type: "error";
+    message: string;
+} | {
+    type: "status";
+    phase: string;
+} | {
+    type: "system";
+    message: string;
+} | {
+    type: "subagent";
+    name: string;
+    status: "started" | "finished";
+    description: string;
+} | {
+    type: "separator";
+};
+/**
+ * How the agent process is hosted.
+ *
+ * Use `{ type: "local" }` (default) to run the agent in-process via `LocalRuntime`.
+ * Use `{ type: "remote"; url: string }` to connect to a pre-running agent over WebSocket.
+ *
+ * @docLink packages/sdk/concepts#core-types
+ */
+export type SessionMode = {
+    type: "local";
+} | {
+    type: "remote";
+    url: string;
+};
+/**
+ * Options for {@link createAgentSession}.
+ *
+ * Controls workspace directory selection, inline agent configuration, mount and connector
+ * declarations, the initial prompt, and whether to run the agent in-process or via WebSocket.
+ *
+ * @docLink packages/sdk/concepts#create-agent-session-options
+ */
+export interface CreateAgentSessionOptions {
+    /**
+     * Path to an existing directory to use as the agent working directory.
+     * If omitted, a temp directory is created under /tmp/skaile-sdk/<timestamp>
+     * and deleted when the session stops (unless keepWorkspace is true).
+     */
+    workspaceDir?: string;
+    /**
+     * Inline agent configuration — serialised to skaile.yaml in the workspace dir.
+     * If workspaceDir already contains a skaile.yaml, this is merged on top.
+     */
+    agent?: {
+        driver?: string;
+        model?: string;
+        provider?: string;
+        maxTurns?: number;
+        permissionMode?: "auto" | "interactive";
+    };
+    /** Mount declarations written to skaile.yaml (filesystem-mounted resources). */
+    mounts?: MountConfig[];
+    /** Connector declarations written to skaile.yaml (tool-accessed backends). */
+    connectors?: ConnectorConfig[];
+    /** Path to SOUL.md / RULES.md directory. Passed to startAgentServer(). */
+    agentDir?: string;
+    /** Initial prompt sent immediately after startup. */
+    initialPrompt?: string;
+    /** How to run the agent. Defaults to "local". */
+    mode?: SessionMode;
+    /**
+     * When true, a temp workspace directory is not deleted on session stop.
+     * No effect when workspaceDir is an existing directory.
+     */
+    keepWorkspace?: boolean;
+}
+/**
+ * Mount declaration for skaile.yaml (filesystem-mounted resources).
+ *
+ * Mounts attach external storage (local directories, git repos, S3 buckets, etc.) to a
+ * workspace-relative path so the agent can read or write files from that source.
+ *
+ * @docLink packages/sdk/concepts#create-agent-session-options
+ */
+export interface MountConfig {
+    id: string;
+    /** Mount driver: "local", "git", "s3", "webdav", "sharepoint". */
+    driver: string;
+    /** What to mount: URL, bucket path, host filesystem path. */
+    source: string;
+    /** Workspace-relative mount point (default: .mounts/<id>). */
+    target?: string;
+    access?: "read-only" | "read-write";
+    auth?: string;
+    options?: Record<string, unknown>;
+}
+/**
+ * Connector declaration for skaile.yaml (tool-accessed backends).
+ *
+ * Connectors expose tool-accessible backends (databases, caches, state stores, etc.) to
+ * the agent. Unlike mounts, they do not occupy a filesystem path — the agent interacts
+ * with them via generated tools.
+ *
+ * @docLink packages/sdk/concepts#create-agent-session-options
+ */
+export interface ConnectorConfig {
+    id: string;
+    /** Connector adapter: "postgres", "redis", "sqlite", "memory", "xstate", "xstate-store", "yjs", etc. */
+    adapter: string;
+    access?: "read-only" | "read-write";
+    auth?: string;
+    options?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../sdk/src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAElF;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAE1B;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;KACzC,CAAC;IAEF,gFAAgF;IAChF,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;IAEvB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAE/B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,iDAAiD;IACjD,IAAI,CAAC,EAAE,WAAW,CAAC;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,GAAG,YAAY,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,wGAAwG;IACxG,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,GAAG,YAAY,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC"}

package/dist/sdk/src/workspace.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Workspace utilities — prepare session directories and write skaile.yaml.
+ */
+import type { CreateAgentSessionOptions } from "./types.js";
+/**
+ * Prepare a workspace directory for a session. Returns the path and cleanup fn.
+ *
+ * If `opts.workspaceDir` is set, that directory is created (if needed) and returned
+ * with no cleanup. Otherwise a temporary directory under `/tmp/skaile-sdk/<timestamp>`
+ * is created; the cleanup function removes it on session stop unless `keepWorkspace` is true.
+ *
+ * @param opts - Session creation options providing `workspaceDir` and `keepWorkspace`.
+ * @returns An object with the resolved `dir` path and an optional `cleanup` function.
+ * @docLink packages/sdk/concepts#workspace-helpers
+ */
+export declare function prepareWorkspace(opts: CreateAgentSessionOptions): {
+    dir: string;
+    cleanup: (() => void) | undefined;
+};
+/**
+ * Write skaile.yaml from inline {@link CreateAgentSessionOptions}.
+ *
+ * Only writes if `agent`, `mounts`, or `connectors` are provided and no `skaile.yaml`
+ * already exists in `dir` (existing config takes precedence). Connector `adapter` fields
+ * are mapped to the `driver` field expected by the core runtime.
+ *
+ * @param dir - Absolute path to the workspace directory.
+ * @param opts - Session options containing agent config, mounts, and connectors to serialize.
+ * @docLink packages/sdk/concepts#workspace-helpers
+ */
+export declare function writeSkaileYaml(dir: string, opts: CreateAgentSessionOptions): void;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/sdk/src/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../sdk/src/workspace.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,yBAAyB,GAAG;IACjE,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;CACnC,CAcA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,GAAG,IAAI,CA+ClF"}

package/dist/sdk/store.js

@@ -0,0 +1,4 @@
+export { AgentStore, ResourceClient } from '../chunk-FQHHCICT.js';
+import '../chunk-NSBPE2FW.js';
+//# sourceMappingURL=store.js.map
+//# sourceMappingURL=store.js.map

package/dist/sdk/store.js.map

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

package/dist/sdk/telemetry.js

@@ -0,0 +1,4 @@
+export { DEFAULT_TELEMETRY_CONFIG, NoopTelemetryProvider, getTelemetry, getTelemetryConfig, initTelemetry, resolveTelemetryConfig } from '../chunk-Y46TBPLI.js';
+import '../chunk-NSBPE2FW.js';
+//# sourceMappingURL=telemetry.js.map
+//# sourceMappingURL=telemetry.js.map

package/dist/sdk/telemetry.js.map

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

package/dist/sdk/transport/ws/client.js

@@ -0,0 +1,4 @@
+export { WebSocketClientTransport } from '../../../chunk-7PTP3SQJ.js';
+import '../../../chunk-NSBPE2FW.js';
+//# sourceMappingURL=client.js.map
+//# sourceMappingURL=client.js.map

package/dist/sdk/transport/ws/client.js.map

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

package/dist/sdk/transport/ws/server.js

@@ -0,0 +1,4 @@
+export { WebSocketServerTransport } from '../../../chunk-XOSBNBB6.js';
+import '../../../chunk-NSBPE2FW.js';
+//# sourceMappingURL=server.js.map
+//# sourceMappingURL=server.js.map

package/dist/sdk/transport/ws/server.js.map

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

package/dist/sdk/transport/ws.js

@@ -0,0 +1,6 @@
+import '../../chunk-W2O5LWYU.js';
+export { WebSocketClientTransport } from '../../chunk-7PTP3SQJ.js';
+export { WebSocketServerTransport } from '../../chunk-XOSBNBB6.js';
+import '../../chunk-NSBPE2FW.js';
+//# sourceMappingURL=ws.js.map
+//# sourceMappingURL=ws.js.map

package/dist/sdk/transport/ws.js.map

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

package/dist/sdk/transport.js

@@ -0,0 +1,7 @@
+import '../chunk-O7SG5PC2.js';
+import '../chunk-W2O5LWYU.js';
+export { WebSocketClientTransport } from '../chunk-7PTP3SQJ.js';
+export { WebSocketServerTransport } from '../chunk-XOSBNBB6.js';
+import '../chunk-NSBPE2FW.js';
+//# sourceMappingURL=transport.js.map
+//# sourceMappingURL=transport.js.map

package/dist/sdk/transport.js.map

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

package/dist/sdk/types.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=types.js.map
+//# sourceMappingURL=types.js.map

package/dist/sdk/types.js.map

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

package/dist/secrets/index.js

@@ -0,0 +1,5 @@
+export { CredentialLifecycleService, EnvSecretsProvider, LocalSecretsProvider, SecretsRouter, VERSION } from '../chunk-JDX54X4Y.js';
+export { ProviderUnavailableError, SecretAccessDeniedError, SecretExpiredError, SecretNotFoundError, SecretsError } from '../chunk-OKRUTSG7.js';
+import '../chunk-NSBPE2FW.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/secrets/index.js.map

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

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

@@ -0,0 +1,12 @@
+/** Package version of `@skaile/secrets`. */
+export declare const VERSION = "0.0.0";
+export type { ISecretsProvider, SecretMetadata, ProviderCapabilities, SetSecretOptions, ListFilter, } from "@skaile/workspaces/plugins";
+export { SecretsError, SecretNotFoundError, SecretAccessDeniedError, SecretExpiredError, ProviderUnavailableError, } from "@skaile/workspaces/plugins";
+export { SecretsRouter } from "./router.js";
+export type { CredentialAccessed, AuditSink, RoutingRule, SecretsRouterConfig } from "./router.js";
+export { LocalSecretsProvider } from "./providers/local.js";
+export type { KeyStrategy } from "./providers/local.js";
+export { EnvSecretsProvider } from "./providers/env.js";
+export { CredentialLifecycleService } from "./lifecycle.js";
+export type { CredentialLifecycleConfig, RefreshResult } from "./lifecycle.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../secrets/src/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,UAAU,GACX,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/secrets/src/lifecycle.d.ts

@@ -0,0 +1,51 @@
+/**
+ * CredentialLifecycleService — manages OAuth token refresh outside the SecretsRouter.
+ *
+ * Works with opaque token blobs stored via the {@link SecretsRouter}; providers remain
+ * OAuth-unaware. Phase 1 ships non-OAuth paths (always returns `not_applicable`).
+ * Full proactive OAuth refresh with expiry checking ships in Phase 3.4.
+ *
+ * @docLink packages/secrets/concepts#credential-lifecycle
+ */
+import type { SecretsRouter } from "./router.js";
+/**
+ * Configuration for {@link CredentialLifecycleService}.
+ *
+ * Controls how aggressively the service proactively refreshes credentials before they expire.
+ * The default lead time is 300 seconds (5 minutes).
+ *
+ * @docLink packages/secrets/concepts#credential-lifecycle
+ */
+export interface CredentialLifecycleConfig {
+    /** How far before expiry to trigger a proactive refresh (seconds). */
+    refreshLeadTimeSec: number;
+}
+/**
+ * Result returned by {@link CredentialLifecycleService.refreshIfNeeded}.
+ *
+ * The `reason` discriminant indicates why a refresh did or did not occur.
+ * An `error` string is present only when `reason` is `refresh_failed`.
+ *
+ * @docLink packages/secrets/concepts#credential-lifecycle
+ */
+export interface RefreshResult {
+    refreshed: boolean;
+    reason: "not_applicable" | "still_valid" | "refreshed" | "refresh_failed";
+    error?: string;
+}
+export declare class CredentialLifecycleService {
+    private router;
+    private config;
+    constructor(router: SecretsRouter, config?: Partial<CredentialLifecycleConfig>);
+    /**
+     * Attempt to refresh a credential if needed.
+     * Phase 1: always returns not_applicable (no OAuth support yet).
+     */
+    refreshIfNeeded(credentialRef: string): Promise<RefreshResult>;
+    /**
+     * Check if a credential is still valid (not expired).
+     * Phase 1: always returns true for non-OAuth credentials.
+     */
+    isValid(credentialRef: string): Promise<boolean>;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/secrets/src/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../secrets/src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,gBAAgB,GAAG,aAAa,GAAG,WAAW,GAAG,gBAAgB,CAAC;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,qBAAa,0BAA0B;IACrC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAA4B;gBAE9B,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC;IAK9E;;;OAGG;IACG,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAWpE;;;OAGG;IACG,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAQvD"}

package/dist/secrets/src/providers/env.d.ts

@@ -0,0 +1,26 @@
+/**
+ * EnvSecretsProvider — read-only provider that resolves secrets from environment variables.
+ *
+ * Refs are expected to be plain env var names (e.g. `DATABASE_URL`). The provider is
+ * always available with zero configuration and requires no encryption or keychain access.
+ * `setSecret` and `deleteSecret` always throw `SecretAccessDeniedError` because
+ * environment variables are managed externally to the running process.
+ *
+ * @docLink packages/secrets/concepts#env-secrets-provider
+ */
+import type { ISecretsProvider, SecretMetadata, ProviderCapabilities, SetSecretOptions, ListFilter } from "@skaile/workspaces/plugins";
+export declare class EnvSecretsProvider implements ISecretsProvider {
+    readonly id = "env";
+    getSecret(ref: string): Promise<Uint8Array>;
+    setSecret(_ref: string, _value: Uint8Array, _opts?: SetSecretOptions): Promise<void>;
+    deleteSecret(_ref: string): Promise<void>;
+    listSecrets(filter?: ListFilter): Promise<string[]>;
+    testConnection(): Promise<{
+        ok: boolean;
+        latencyMs?: number;
+        error?: string;
+    }>;
+    getMetadata(ref: string): Promise<SecretMetadata>;
+    getCapabilities(): ProviderCapabilities;
+}
+//# sourceMappingURL=env.d.ts.map

package/dist/secrets/src/providers/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../../secrets/src/providers/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,UAAU,EACX,MAAM,4BAA4B,CAAC;AAGpC,qBAAa,kBAAmB,YAAW,gBAAgB;IACzD,QAAQ,CAAC,EAAE,SAAS;IAEd,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAQ3C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpF,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,WAAW,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAWnD,cAAc,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAI9E,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAcvD,eAAe,IAAI,oBAAoB;CAQxC"}