@skaile/workspaces 0.8.5

package/dist/resolver/src/preamble.d.ts

@@ -0,0 +1,32 @@
+import type { SkillRequirements } from "./types.js";
+/**
+ * Generate a DSL-format preamble from skill requirements.
+ *
+ * The preamble is prepended to the skill prompt when the skill runs standalone
+ * (without an orchestrator), giving the agent an explicit checklist of what to
+ * verify before starting work. Each section maps to a requirement category:
+ *
+ * - `REQUIRES` — file/directory gates (`hard:` or `soft:` prefix)
+ * - `INPUT`    — user input fields, with a pointer to `input.json` if `skillId` is provided
+ * - `READS`    — informational read sources (not gated)
+ * - `WRITES`   — files the skill will produce
+ * - `RESOURCE` — runtime resource dependencies
+ *
+ * Sections with no entries are omitted. Returns an empty string when all
+ * requirement arrays are empty.
+ *
+ * @param requirements - Parsed requirements (output of `parseSkillRequirements`)
+ * @param skillId - Optional skill identifier; when provided, the INPUT section includes
+ *   the canonical `input.json` path so the agent knows where to read collected values
+ * @returns Multi-section DSL string, or `""` if there are no requirements to list
+ *
+ * @example
+ * ```ts
+ * const preamble = buildRequiresPreamble(requirements, "cf_overview");
+ * const fullPrompt = preamble ? `${preamble}\n\n${skillBody}` : skillBody;
+ * ```
+ *
+ * @docLink packages/resolver/api-reference#build-requires-preamble
+ */
+export declare function buildRequiresPreamble(requirements: SkillRequirements, skillId?: string): string;
+//# sourceMappingURL=preamble.d.ts.map

package/dist/resolver/src/preamble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preamble.d.ts","sourceRoot":"","sources":["../../../resolver/src/preamble.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAgE/F"}

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

@@ -0,0 +1,279 @@
+/**
+ * A single file or directory requirement declared in SKILL.md frontmatter.
+ *
+ * @docLink packages/resolver/concepts#file-requirements
+ */
+export interface FileRequirement {
+    /** Relative path pattern (glob or literal) to check in the workspace. */
+    path: string;
+    /** Hard gate blocks execution if missing; soft gate produces a warning only. */
+    gate: "hard" | "soft";
+    /** Human-readable description of why this file is needed. */
+    description: string;
+    /** For directories: minimum number of files required recursively. */
+    min_entries?: number;
+}
+/**
+ * Supported input field types in skill frontmatter.
+ *
+ * @docLink packages/resolver/concepts#input-fields
+ */
+export type InputFieldType = "text" | "textarea" | "select" | "multiselect" | "boolean" | "number";
+/**
+ * A user-input field declared in SKILL.md frontmatter.
+ * Collected interactively by the CLI/UI and stored in input.json.
+ *
+ * @docLink packages/resolver/concepts#input-fields
+ */
+export interface InputField {
+    /** Machine key used as the variable name in the skill prompt. */
+    id: string;
+    /** Human-readable label shown in the UI. */
+    label: string;
+    /** Input type selector. */
+    type: InputFieldType;
+    /** When true, the skill cannot proceed without this value. */
+    required: boolean;
+    /** Valid options for select/multiselect types. */
+    options?: string[];
+    /** Default value if the user does not provide one. */
+    default?: any;
+    /** Helper text shown alongside the input field. */
+    hint?: string;
+    /** Optional JSON Schema fragment for additional validation. */
+    schema?: Record<string, any>;
+}
+/**
+ * A file or directory that the skill reads but does not declare as a prerequisite gate.
+ * Listed in the `READS` preamble block so the agent knows to locate these before starting.
+ *
+ * @docLink packages/resolver/concepts#read-sources
+ */
+export interface ReadSource {
+    /** Relative path (from project root) to the file or directory the skill reads. */
+    path: string;
+    /** Human-readable explanation of why the skill reads this resource. */
+    description: string;
+}
+/**
+ * A file or directory that the skill will create or update.
+ * Listed in the `WRITES` preamble block so the agent and orchestrator
+ * know what this skill produces (used to satisfy downstream `FileRequirement` gates).
+ *
+ * @docLink packages/resolver/concepts#produces-entries
+ */
+export interface ProducesEntry {
+    /** Relative path (from project root) of the file or directory this skill will write. */
+    path: string;
+    /** Human-readable description of the produced artifact. */
+    description: string;
+}
+/**
+ * A runtime resource (connector, mount, or external service) that the skill requires.
+ * Declared under `metadata.prerequisites.resources[]` in SKILL.md frontmatter.
+ * Actual availability is verified by the runner's `ResourceManager`; the resolver
+ * only records the declaration in the report.
+ *
+ * @docLink packages/resolver/concepts#resource-requirements
+ */
+export interface ResourceRequirement {
+    /** Resource ID that must be available. */
+    id: string;
+    /** Specific operations the skill uses (all if omitted). */
+    operations?: string[];
+    /** Soft gate — warn but don't block. Default: false (hard gate). */
+    optional?: boolean;
+    /** Human-readable description. */
+    description?: string;
+}
+/**
+ * A connector driver a skill declares as required to function.
+ *
+ * @docLink packages/resolver/concepts#connector-requirements
+ */
+export interface ConnectorRequirement {
+    /** Driver name that must be present in skaile.yaml connectors. */
+    driver: string;
+    /** Minimum access level required. Default: "read-only". */
+    access?: "read-only" | "read-write";
+}
+/**
+ * All requirements parsed from a single SKILL.md frontmatter block.
+ * Returned by `parseSkillRequirements()` and consumed by `validateRequirements()`.
+ *
+ * @docLink packages/resolver/concepts#skillrequirements-type
+ */
+export interface SkillRequirements {
+    /** File and directory prerequisites with hard/soft gate semantics. */
+    files: FileRequirement[];
+    /** Input fields that must be supplied before the skill can run. */
+    inputs_required: InputField[];
+    /** Input fields that enhance skill output but are not blocking. */
+    inputs_optional: InputField[];
+    /** Files or directories the skill reads (informational, not gated). */
+    reads: ReadSource[];
+    /** Files or directories the skill will create or update. */
+    produces: ProducesEntry[];
+    /** Runtime resources (connectors, mounts) the skill depends on. */
+    resources: ResourceRequirement[];
+    /** Connector drivers the skill requires to be declared in skaile.yaml. */
+    connectors: ConnectorRequirement[];
+}
+/**
+ * Validation result for a single `FileRequirement`.
+ * Produced by `validateRequirements()` for each declared file prerequisite.
+ *
+ * @docLink packages/resolver/concepts#validation-report
+ */
+export interface FileCheck {
+    /** Relative path that was checked (mirrors `FileRequirement.path`). */
+    path: string;
+    /** Gate severity — determines whether a failure blocks execution. */
+    gate: "hard" | "soft";
+    /** Whether the file or directory exists (and meets `min_entries` if set). */
+    exists: boolean;
+    /** Human-readable description copied from the requirement declaration. */
+    description: string;
+    /** Skill ID that declares this file as a `produces` output, if found in the active flow context. */
+    producedBy?: string;
+}
+/**
+ * Validation result for a single `InputField`.
+ * Present for both required and optional inputs regardless of whether a value was found.
+ *
+ * @docLink packages/resolver/concepts#validation-report
+ */
+export interface InputCheck {
+    /** Input field key, matching `InputField.id`. */
+    id: string;
+    /** Whether the field was declared as required. */
+    required: boolean;
+    /** Whether a value for this field exists in the skill's `input.json`. */
+    present: boolean;
+    /** Full field declaration, available for rendering prompts or defaults. */
+    field: InputField;
+}
+/**
+ * Validation result for a single `ReadSource`.
+ * Always informational — read sources are never blocking.
+ *
+ * @docLink packages/resolver/concepts#validation-report
+ */
+export interface ReadCheck {
+    /** Relative path that was checked (mirrors `ReadSource.path`). */
+    path: string;
+    /** Whether the file or directory exists at validation time. */
+    exists: boolean;
+    /** Human-readable description copied from the requirement declaration. */
+    description: string;
+}
+/**
+ * Validation result for a single `ResourceRequirement`.
+ * Availability is set to `true` by the resolver; actual availability
+ * is determined at a higher level by the runner's `ResourceManager`.
+ *
+ * @docLink packages/resolver/concepts#validation-report
+ */
+export interface ResourceCheck {
+    /** Resource ID (mirrors `ResourceRequirement.id`). */
+    id: string;
+    /** Whether the resource is considered available (always `true` at resolver level). */
+    available: boolean;
+    /** Operations declared as needed but not yet confirmed available. */
+    missingOps: string[];
+    /** Whether a missing resource is non-blocking (mirrors `ResourceRequirement.optional`). */
+    optional: boolean;
+}
+/**
+ * Aggregate result returned by `validateRequirements()`.
+ * The caller uses `satisfied` to decide whether to proceed with skill execution.
+ *
+ * @docLink packages/resolver/concepts#validation-report
+ */
+export interface RequirementsReport {
+    /** Canonical skill identifier (matches the directory name in `ai-assets/`). */
+    skillId: string;
+    /** True when all hard gates pass AND all required inputs/resources are present */
+    satisfied: boolean;
+    /** Per-file check results, in declaration order. */
+    files: FileCheck[];
+    /** Per-input check results, required inputs first then optional. */
+    inputs: InputCheck[];
+    /** Per-read-source check results (informational). */
+    reads: ReadCheck[];
+    /** Per-resource check results. */
+    resources: ResourceCheck[];
+}
+/**
+ * Event emitted by the runner or CLI when input collection is needed before a skill can run.
+ * Consumers (UI, CLI, agent) should prompt the user and respond with `InputResponseEvent`.
+ *
+ * @remarks
+ * This is a scaffold type — the event streaming infrastructure is not yet implemented.
+ *
+ * @docLink packages/resolver/concepts#input-collection-events
+ */
+export interface InputRequestEvent {
+    /** Discriminant identifying this as an input-collection request. */
+    type: "input_request";
+    /** Canonical ID of the skill that requires inputs. */
+    skillId: string;
+    /** Flow node context (if running in flow) */
+    nodeId?: string;
+    /** Ordered list of input fields the consumer must collect. */
+    fields: InputField[];
+    /** Target file path for collected inputs. */
+    writeTo: string;
+    /** Timeout ms before skipping optional inputs. */
+    deadline?: number;
+}
+/**
+ * Event emitted by the UI/CLI/agent after collecting skill inputs and writing `input.json`.
+ * Consumed by the runner to confirm that inputs are available before proceeding.
+ *
+ * @remarks
+ * This is a scaffold type — the event streaming infrastructure is not yet implemented.
+ *
+ * @docLink packages/resolver/concepts#input-collection-events
+ */
+export interface InputResponseEvent {
+    /** Discriminant identifying this as a collected-inputs response. */
+    type: "input_response";
+    /** Canonical ID of the skill whose inputs were collected. */
+    skillId: string;
+    /** Flow node context that originated the request, if applicable. */
+    nodeId?: string;
+    /** Collected field values keyed by `InputField.id`. */
+    values: Record<string, any>;
+    /** Absolute or relative path of the file written by the consumer, echoing the writeTo field of the originating request. */
+    writtenTo: string;
+}
+/**
+ * Shape of the input.json file written by UI/CLI/agent.
+ *
+ * @docLink packages/resolver/concepts#input-collection
+ */
+export interface SkillInputFile {
+    /** Optional JSON Schema URI for editor tooling. */
+    $schema?: string;
+    /** Canonical skill identifier that this input file belongs to. */
+    skill: string;
+    /** ISO 8601 timestamp of when the inputs were collected. */
+    collected_at: string;
+    /** Which surface collected the inputs — used for auditing and replay. */
+    collected_by: "cli" | "ui" | "agent";
+    /** Field values keyed by `InputField.id`. */
+    values: Record<string, any>;
+}
+/**
+ * Per-node overrides applied by the flow engine before requirement validation.
+ * Allows prior nodes to signal that certain prerequisites are already satisfied,
+ * preventing redundant filesystem checks for files they are guaranteed to produce.
+ *
+ * @docLink packages/resolver/concepts#flow-overrides
+ */
+export interface NodeOverrides {
+    /** File paths to skip checking (guaranteed by prior nodes). */
+    skip_checks?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/resolver/src/validator.d.ts

@@ -0,0 +1,55 @@
+import type { ConnectorRequirement, NodeOverrides, RequirementsReport, SkillRequirements } from "./types.js";
+/**
+ * Validate skill requirements against the filesystem and collected inputs.
+ *
+ * File checks resolve paths relative to `projectDir`. Hard-gate files that are absent
+ * set `satisfied: false` on the returned report; soft-gate misses are recorded but do not block.
+ * Input checks read `_concept/_grounding/{skillId}/input.json`; missing files are treated as
+ * no inputs collected. Resource checks are always recorded as `available: true` — actual
+ * availability must be confirmed by the runner's `ResourceManager`.
+ *
+ * @param skillId - Canonical skill identifier, used to locate `input.json`
+ * @param requirements - Parsed requirements from SKILL.md (`parseSkillRequirements` output)
+ * @param projectDir - Absolute path to the project root directory
+ * @param overrides - Optional flow-level overrides; paths in `skip_checks` are treated as present
+ * @param producesIndex - Maps file paths to the skill ID that produces them, enabling "produced by" hints in the report
+ * @returns `RequirementsReport` with per-check results and an overall `satisfied` flag
+ *
+ * @docLink packages/resolver/api-reference#validate-requirements
+ */
+export declare function validateRequirements(skillId: string, requirements: SkillRequirements, projectDir: string, overrides?: NodeOverrides, producesIndex?: Map<string, string>): RequirementsReport;
+/**
+ * A warning produced by `validateConnectorRequirements` when a skill's declared
+ * connector requirement is not satisfied by the connectors in skaile.yaml.
+ * Each warning covers either a missing driver or an insufficient access level.
+ *
+ * @docLink packages/resolver/api-reference#connector-validation-warning
+ */
+export interface ConnectorValidationWarning {
+    /** Driver name that triggered the warning. */
+    driver: string;
+    /** Human-readable explanation of the gap, including a remediation command where applicable. */
+    message: string;
+}
+/** Minimal structural type accepted by validateConnectorRequirements. Compatible with both
+ *  ConnectorDeclaration shapes in @skaile/workspaces/core and @skaile/workspaces/connectors. */
+interface AvailableConnector {
+    driver: string;
+    access?: "read-only" | "read-write";
+}
+/**
+ * Check that all connector requirements declared in a skill's SKILL.md are
+ * satisfied by the connectors declared in skaile.yaml.
+ *
+ * Returns one warning per gap — either a missing driver or an insufficient
+ * access level. This is a pre-flight advisory; no runtime enforcement is done.
+ *
+ * @param requirements - Connector requirements from `parseSkillRequirements().connectors`
+ * @param available - Connector declarations from `skaile.yaml` (via `loadConnectorDeclarations`)
+ * @returns Array of warnings — one per gap. Empty array when all requirements are satisfied.
+ *
+ * @docLink packages/resolver/api-reference#validate-connector-requirements
+ */
+export declare function validateConnectorRequirements(requirements: ConnectorRequirement[], available: AvailableConnector[]): ConnectorValidationWarning[];
+export {};
+//# sourceMappingURL=validator.d.ts.map

package/dist/resolver/src/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../resolver/src/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EAGpB,aAAa,EAEb,kBAAkB,EAGlB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,iBAAiB,EAC/B,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,aAAa,EACzB,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,kBAAkB,CA4EpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,+FAA+F;IAC/F,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;gGACgG;AAChG,UAAU,kBAAkB;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,GAAG,YAAY,CAAC;CACrC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,oBAAoB,EAAE,EACpC,SAAS,EAAE,kBAAkB,EAAE,GAC9B,0BAA0B,EAAE,CA8B9B"}

package/dist/resolver/src/version.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Result of a single flow-node version pin check.
+ * Returned in the array produced by `validateFlowVersions()` for every
+ * node that declares a `requestedVersion`.
+ *
+ * @docLink packages/resolver/api-reference#version-check
+ */
+export interface VersionCheck {
+    /** Flow node identifier. */
+    nodeId: string;
+    /** Canonical skill identifier. */
+    skillId: string;
+    /** Semver range from the flow node (e.g. "^1.0.0") */
+    requested: string;
+    /** Version from the skill's frontmatter */
+    actual: string;
+    /** Whether `actual` satisfies the `requested` semver range. */
+    satisfied: boolean;
+}
+/**
+ * Minimal descriptor for a flow node that optionally pins a skill version.
+ * Passed as input to `validateFlowVersions()`. Nodes without `requestedVersion`
+ * are skipped during version checking.
+ *
+ * @docLink packages/resolver/api-reference#flow-version-node
+ */
+export interface FlowVersionNode {
+    /** Flow node identifier. */
+    nodeId: string;
+    /** Canonical skill identifier referenced by this node. */
+    skillId: string;
+    /** Optional semver range the node requires (e.g. `"^1.2.0"`). Omit to skip version checking. */
+    requestedVersion?: string;
+}
+/**
+ * Validate flow node version pins against discovered skill versions.
+ *
+ * Only checks nodes that declare a `requestedVersion`. Nodes without a
+ * version pin are skipped entirely (no entry is produced for those nodes).
+ * A check is marked `satisfied: false` when the range is invalid, the actual
+ * version string is not valid semver, or the version does not satisfy the range.
+ *
+ * @param nodes - Flow nodes to check; only those with `requestedVersion` are evaluated
+ * @param skillVersions - Map from skill ID to the semver version string in its frontmatter
+ * @returns Array of `VersionCheck` results, one per node that declared a version pin
+ *
+ * @docLink packages/resolver/api-reference#validate-flow-versions
+ */
+export declare function validateFlowVersions(nodes: FlowVersionNode[], skillVersions: Map<string, string>): VersionCheck[];
+//# sourceMappingURL=version.d.ts.map

package/dist/resolver/src/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../resolver/src/version.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,gGAAgG;IAChG,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,eAAe,EAAE,EACxB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,YAAY,EAAE,CAwBhB"}

package/dist/runner/index.js

@@ -0,0 +1,34 @@
+export { CLAUDE_CODE_CREDENTIALS_KEY, COMPILE_MANIFEST_FILENAME, CapabilityRegistry, DEFAULT_CAPABILITY_CALL_TIMEOUT_MS, DEFAULT_COALESCE_MS, MarkdownStreamer, PreInitRingSink, agentDefinitionExists, assembleSystemPrompt, bootstrapCapabilityRegistry, bootstrapRunnerLogStore, buildAgentResources, buildCapabilitiesPromptSection, buildClientCapabilityHandler, buildContextSection, buildEnvironmentSection, builtinCapabilities, clearPreInitRingSink, clearSession, compileComposition, computeCapabilitySignature, createAgentSession, createSessionStimulusBus, defineCapability, deleteSession, emitSystemPromptComposed, ensureGitConfigInclude, getPreInitRingSink, handleMountResourceRequest, handleResourceRequest, installPreInitRingSink, listSessions, loadAgentManifest, loadCompileManifest, loadCompileManifestFromDir, loadSession, loadSessionById, newSession, registerCompositionCapabilities, rejectCapabilityOnApprovalDeny, resetRunnerLogStore, resolveAgentComposition, resolveAgentMixins, resolveBinding, resolveCapabilityResult, resolveComposition, resolveMixin, runAgentChat, saveSession, setCurrentSession, startAgentServer, touchSession, writeClaudeCodeCredentialsFile } from '../chunk-NYJKXVG6.js';
+import '../chunk-MJHLQRJJ.js';
+import '../chunk-X5YPJV4N.js';
+import '../chunk-O5AE4QDX.js';
+import '../chunk-O7SG5PC2.js';
+import '../chunk-W2O5LWYU.js';
+import '../chunk-7PTP3SQJ.js';
+import '../chunk-XOSBNBB6.js';
+import '../chunk-CCKGX5AS.js';
+import '../chunk-EWP5HZBV.js';
+import '../chunk-KOVLSBXK.js';
+import '../chunk-RRVQAE5D.js';
+import '../chunk-MBBTBKAS.js';
+import '../chunk-LV2HPH3C.js';
+import '../chunk-3W7Z74ZP.js';
+import '../chunk-Q5URN24L.js';
+import '../chunk-7H7EOIRH.js';
+import '../chunk-GCRKAFH7.js';
+import '../chunk-ZUQIXLRJ.js';
+import '../chunk-GZWJGNNN.js';
+import '../chunk-FVTV7M76.js';
+export { globalSettingsPath, loadSettings, mapLegacyFields, projectSettingsPath, resolveSettings, saveSettings } from '../chunk-65CYXYUW.js';
+import '../chunk-JKNWJ64A.js';
+export { DRIVER_TARGETS, SUPPORTED_DRIVER_TARGETS } from '../chunk-O4JH3KUE.js';
+export { DRIVER_DEFAULTS, resolveDriverPaths } from '../chunk-K5GBV4SA.js';
+import '../chunk-KLNL7QHN.js';
+import '../chunk-XEGHWFAX.js';
+import '../chunk-CSUBFKAN.js';
+import '../chunk-BVHFSUFM.js';
+import '../chunk-JLPC4YWT.js';
+import '../chunk-V37HONL7.js';
+import '../chunk-NSBPE2FW.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/runner/index.js.map

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

package/dist/runner/src/agent.d.ts

@@ -0,0 +1,52 @@
+/**
+ * agent.ts
+ *
+ * Single-shot agent chat — runs a driver session without a flow.
+ * Useful for ad-hoc tasks and skill invocations.
+ *
+ * The interactive REPL lives at @skaile/workspaces/tui (startRepl).
+ */
+import type { AgentEvent } from "@skaile/workspaces/bridge";
+/**
+ * Options for the agent REPL session (legacy).
+ *
+ * @docLink packages/runner/dev-guide#agent-chat-single-shot
+ */
+export interface AgentReplOptions {
+    /** GitAgent definition directory (SOUL.md, RULES.md, knowledge/) */
+    agentDir?: string;
+    /** Project working directory for the agent */
+    projectDir: string;
+    /** Bridge driver: 'omp' | 'claude-sdk' | 'codex' (default: 'omp') */
+    driver?: string;
+    /** LLM model override */
+    model?: string;
+    /** LLM provider override */
+    provider?: string;
+    /** Path to settings.json for API key resolution */
+    settingsFile?: string;
+    /** Called for every raw agent event */
+    onEvent?: (event: AgentEvent) => void;
+    /** Called for log lines */
+    onLog?: (line: string) => void;
+    /** Prompts directory for deployed command files */
+    promptsDir?: string;
+}
+/**
+ * Options for a single-shot agent chat session.
+ *
+ * @docLink packages/runner/dev-guide#agent-chat-single-shot
+ */
+export interface AgentChatOptions extends AgentReplOptions {
+    /** The message to send */
+    message: string;
+    /** Optional skill ID — if provided, the skill prompt is prepended */
+    skill?: string;
+}
+/**
+ * Send a single message to an agent and wait for the response.
+ * Prints agent output to stdout, then exits.
+ * @docLink packages/runner/dev-guide#agent-chat-single-shot
+ */
+export declare function runAgentChat(opts: AgentChatOptions): Promise<void>;
+//# sourceMappingURL=agent.d.ts.map

package/dist/runner/src/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../runner/src/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,2BAA2B,CAAC;AAY1E;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA6BD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsExE"}

package/dist/runner/src/builtin-capabilities.d.ts

@@ -0,0 +1,23 @@
+import type { CapabilityRegistry } from "./capability-registry.js";
+import { type DefinedCapability } from "./define-capability.js";
+/**
+ * Build the three built-in discovery capabilities. They close over the
+ * registry so the handlers stay in sync with mid-session register /
+ * deregister events.
+ *
+ * @category Runtime
+ * @since 2.0.0
+ * @docLink packages/runner/capabilities#built-in-discovery-capabilities
+ */
+export declare function builtinCapabilities(registry: CapabilityRegistry): DefinedCapability[];
+/**
+ * Register all framework built-ins onto a registry. Idempotent — the
+ * registry's `register` is keyed by name and overwrites prior entries with
+ * the same name.
+ *
+ * @category Runtime
+ * @since 2.0.0
+ * @docLink packages/runner/capabilities#built-in-discovery-capabilities
+ */
+export declare function bootstrapCapabilityRegistry(registry: CapabilityRegistry): void;
+//# sourceMappingURL=builtin-capabilities.d.ts.map

package/dist/runner/src/builtin-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-capabilities.d.ts","sourceRoot":"","sources":["../../../runner/src/builtin-capabilities.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AA+BlF;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,iBAAiB,EAAE,CAgErF;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAI9E"}