@nocobase/app-plugin-agents 0.0.0-stage → 0.1.0-beta.10

package/dist/shared/runs.d.ts

@@ -0,0 +1,407 @@
+/**
+ * Runs as the browser and the server's admin API exchange them.
+ */
+import type { ActorKind, AgentTool, FailureReason, RunEvent, RunEventType, RunInputType, RunnerFeature, RunStatus } from '@nocobase/agent-protocol';
+import type { VariableRef } from './variables.js';
+/** The run subject kind of a consultation: an online agent asking another a question (`ask_agent`). */
+export declare const CONSULTATION_SUBJECT = "consultation";
+/** How deep consultations go: the agent asked may ask another, which may not ask further. */
+export declare const CONSULT_MAX_DEPTH = 2;
+/** Execution facts captured at claim time, retained even after a retry releases its holder. */
+export interface RunEffortReport {
+    readonly effort: string | null;
+    /** The tool response that reported the value, never the requested configuration. */
+    readonly source: string;
+    readonly at: string;
+}
+export interface RunExecutionSnapshot {
+    readonly selection?: {
+        readonly reason: 'preferredQueued' | 'preferredUnavailable';
+        readonly preferredTool: string;
+        readonly preferredModel: string | null;
+        readonly queueEnteredAt: string;
+        readonly waitedSeconds: number;
+    };
+    readonly attempt: number;
+    readonly runnerId: string;
+    readonly runnerName: string | null;
+    readonly runnerOwnerUserId: string | null;
+    readonly runnerOwnerName: string | null;
+    readonly runnerTrust: 'team' | 'ownerOnly' | null;
+    readonly tool: string | null;
+    readonly toolVersion: string | null;
+    readonly modelService: string | null;
+    /** Requested model; null means the tool's default. */
+    readonly model: string | null;
+    /** Models reported by this attempt's primary tool, excluding other tools' usage. */
+    readonly actualModels: readonly string[];
+    /** Requested effort, never evidence of what the tool used. */
+    readonly effort: string | null;
+    readonly effortReports?: readonly RunEffortReport[];
+    /** Latest accepted observation, including repeats; distinct from the value/source change time. */
+    readonly actualEffortObservedAt?: string;
+    readonly actualEffort?: string | null;
+    readonly actualEffortSource?: string | null;
+    readonly actualEffortAt?: string | null;
+    /** Machine fields were removed for this reader. */
+    readonly machineHidden?: boolean;
+    readonly dispatchedAt: string;
+    readonly finishedAt: string | null;
+    readonly failureReason: string | null;
+}
+export type ModelWaitReason = 'updatePending' | 'pruning' | 'ready' | 'busy' | 'incompatible' | 'offline' | 'restricted' | 'noSharedRunner' | 'toolNotInstalled' | 'toolUnavailable' | 'unknown' | 'concurrencyFull' | 'sameWorkActive' | 'delayed';
+export interface ModelSelectionWait {
+    readonly queueEnteredAt: string;
+    readonly fallbackAfterSeconds: number;
+    readonly sampledAt: string;
+    readonly entries: readonly {
+        readonly tool: string;
+        readonly model: string | null;
+        readonly reason: ModelWaitReason;
+        readonly compatibleCount: number;
+        readonly blockers?: readonly ModelWaitReason[];
+        readonly runners: readonly {
+            readonly name: string;
+            readonly reason?: ModelWaitReason;
+            readonly lastSeenAt?: string | null;
+            readonly ownerUserId: string | null;
+            readonly used?: number;
+            readonly limit?: number;
+            readonly toolUsed?: number;
+            readonly toolLimit?: number;
+            readonly reportedFree?: number;
+            readonly reportedTotalFree?: number;
+        }[];
+    }[];
+}
+export interface Run {
+    readonly id: string;
+    readonly agentId: string;
+    /** The agent's type (`AgentType`): an `online` run is held by the application itself, a `runner` run by a runner. */
+    readonly agentType: 'online' | 'runner';
+    /** The runner holding it; `server:<instance>` for an online run held by an application instance. */
+    readonly runnerId: string | null;
+    /** Claim snapshots, oldest first. Absent on responses from older servers. */
+    readonly executions?: readonly RunExecutionSnapshot[];
+    /** The latest attempt's runner, including while queued again. Null when no snapshot exists. */
+    readonly runnerName?: string | null;
+    readonly runnerOwnerUserId?: string | null;
+    readonly runnerOwnerName?: string | null;
+    readonly toolVersion?: string | null;
+    readonly actualModels?: readonly string[];
+    readonly actualEffort?: string | null;
+    readonly actualEffortSource?: string | null;
+    readonly actualEffortAt?: string | null;
+    readonly machineHidden?: boolean;
+    /**
+     * The entry of the agent's list it works with (`AgentModelEntry`): a runner run's coding tool and model (null: the
+     * tool's default), set when a runner claims it; an online run's model service and model, set when it is claimed (a
+     * conversation's choice, else the agent's first entry). Null fields while nothing settled them.
+     */
+    readonly tool: AgentTool | null;
+    readonly modelService: string | null;
+    readonly model: string | null;
+    /** The entry's reasoning effort, settled with it; null for the tool's or provider's default. */
+    readonly effort: string | null;
+    readonly status: RunStatus;
+    readonly priority: number;
+    readonly attempt: number;
+    readonly maxAttempts: number;
+    readonly retryOfRunId: string | null;
+    /**
+     * A consultation: the run whose agent asked this run's agent a question (`ask_agent`), which waited for its answer.
+     * Null for every other run.
+     */
+    readonly parentRunId: string | null;
+    readonly subject: {
+        readonly kind: string;
+        readonly id: string;
+    };
+    readonly threadScope: string;
+    /** The run was asked to start a new session; absent on older servers. */
+    readonly freshSession?: boolean;
+    /** The person the run acts as: their permissions bound it, and only their own runners (or team runners) take it. */
+    readonly actorUserId: string;
+    /**
+     * Who the chain of work the run belongs to started with: the person whose action woke the agent, or for work a run
+     * caused, that run's source. The actor when they started it themselves.
+     */
+    readonly requestedByUserId: string;
+    /** Who confirmed the run request the run was queued from (`RunRequest`); null for work its actor started. */
+    readonly confirmedByUserId: string | null;
+    readonly ownerUserId: string | null;
+    readonly requires: readonly RunnerFeature[];
+    readonly acceptsInput: boolean;
+    readonly availableAt: string | null;
+    /** Start of this queue episode; older servers may omit it. */
+    readonly queueEnteredAt?: string | null;
+    readonly leaseExpiresAt: string | null;
+    readonly dispatchedAt: string | null;
+    readonly startedAt: string | null;
+    readonly finishedAt: string | null;
+    readonly lastActivityAt: string | null;
+    readonly cancelRequestedAt: string | null;
+    readonly failureReason: FailureReason | null;
+    readonly failureDetail: string | null;
+    readonly summary: string | null;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+export interface RunInputRecord {
+    readonly id: string;
+    readonly type: RunInputType;
+    readonly actor: {
+        readonly kind: ActorKind;
+        readonly id: string;
+        readonly name: string;
+    };
+    readonly text: string;
+    readonly payload: unknown;
+    readonly createdAt: string;
+    readonly deliveredAt: string | null;
+    readonly handledAt: string | null;
+}
+export interface RunRepo {
+    readonly url: string;
+    readonly branch: string;
+    readonly pushed: boolean;
+    readonly headSha: string | null;
+    /**
+     * Why the runner could not push it at the end of the run (`RepoReport.failure`: `authFailed`,
+     * `credentialUnavailable`, `credentialDenied`, `leaseLost`, `rejected` or `error`), with a redacted message; null
+     * when it pushed or did not try. Optional so existing application schemas and older reports remain compatible;
+     * this server always includes it.
+     */
+    readonly failure?: {
+        readonly reason: string;
+        readonly message: string;
+    } | null;
+    readonly updatedAt: string;
+}
+export interface RunUsageTotal {
+    readonly tool: string;
+    readonly model: string | null;
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens: number;
+    readonly cacheWriteTokens: number;
+    readonly reasoningTokens: number;
+}
+/** A consultation a run made (`ask_agent`): the run of the agent it asked. */
+export interface RunChild {
+    readonly id: string;
+    readonly agentId: string;
+    /** The agent's name; null when it was deleted. */
+    readonly agentName: string | null;
+    readonly status: RunStatus;
+    readonly failureReason: FailureReason | null;
+    /** Its answer. */
+    readonly summary: string | null;
+    readonly createdAt: string;
+    readonly finishedAt: string | null;
+}
+export interface RunDetail extends Run {
+    readonly actorName?: string;
+    readonly requestedByName?: string;
+    /** The first run that retried this one; absent on older servers. */
+    readonly retriedRunId?: string | null;
+    readonly inputs: readonly RunInputRecord[];
+    readonly repos: readonly RunRepo[];
+    readonly usage: readonly RunUsageTotal[];
+    /** The consultations it made, oldest first; each is a run of its own, with its own usage. */
+    readonly children: readonly RunChild[];
+}
+/** One page of a run's transcript, after a `seq`. */
+export interface RunEventPage {
+    readonly events: readonly RunEvent[];
+    /** The highest `seq` returned, to ask for the next page with. */
+    readonly lastSeq: number;
+}
+/**
+ * Why a queued run has not been taken yet, as far as the claim's own rules tell (`RunService.workload`), checked in
+ * this order:
+ *
+ * - `agentArchived`: its agent is archived or gone; the sweeper cancels it.
+ * - `delayed`: it was given a moment (`fireAt`, or a retry's backoff) that has not come; `until` says when.
+ * - `noRunnerOnline`: no runner is online at all.
+ * - `runnersOffline`: the agent names its runners, and none of them is online.
+ * - `toolUnavailable`: runners are online, but none has any of the agent's coding tools enabled, installed and
+ *   signed in.
+ * - `noSharedRunner`: only personal runners could take it, and none belongs to the person who woke the agent.
+ * - `missingFeatures`: the runners that could take it lack what it needs (`missing`).
+ * - `secretsNotAllowed`: some of its variables are for team runners only (`variables` names them), and the runners
+ *   that could take it are personal ones.
+ * - `sameWorkActive`: the agent is already working on the same subject and thread; this run follows.
+ * - `concurrencyFull`: the agent has as many runs held as it may have at once.
+ * - `runnersBusy`: every runner that could take it has its slots full (the machine's slots).
+ * - `toolSlotsFull`: a runner that could take it has a free slot, but none has room for any of the agent's coding tools
+ *   (`Runner.toolSlots`); `tool` names the one that is full.
+ * - `setupRetrying`: preparing it failed and is tried again (`detail` says why).
+ * - `next`: nothing holds it; the next free runner that asks takes it.
+ */
+export declare const RUN_WAIT_REASONS: readonly ["updatePending", "pruning", "agentArchived", "incompatible", "toolNotInstalled", "restricted", "unknown", "delayed", "noRunnerOnline", "runnersOffline", "toolUnavailable", "noSharedRunner", "missingFeatures", "secretsNotAllowed", "sameWorkActive", "concurrencyFull", "runnersBusy", "toolSlotsFull", "setupRetrying", "next"];
+export type RunWaitReason = (typeof RUN_WAIT_REASONS)[number];
+/**
+ * What a wait's words need, by reason: the server sends codes and these, never text, and the client words them
+ * (`formatRunWait` in `client/runs.ts`, or the application's own). Absent for a reason that needs nothing.
+ *
+ * - `delayed`: `until` (RFC 3339).
+ * - `toolUnavailable`: `tool`, the agent's default coding tool.
+ * - `missingFeatures`: `features`, what no fitting runner has.
+ * - `secretsNotAllowed`: `variables`, the names of the variables for team runners only.
+ * - `concurrencyFull`: `active`, `limit`, the agent's runs held and its limit.
+ * - `runnersBusy`: `runners`, how many fitting runners have their slots full.
+ * - `toolSlotsFull`: `tool`, `used`, `limit`, that tool's runs and limit on the fitting runner closest to room.
+ * - `setupRetrying`: `detail`, why preparing it failed.
+ */
+export type RunWaitParams = Readonly<Record<string, string | number | readonly string[]>>;
+/** Where a queued run stands and what holds it. */
+export interface RunWait {
+    readonly reason: RunWaitReason;
+    /** Its place among the runs that may be claimed now, in claim order (1 first); null while delayed. */
+    readonly position: number | null;
+    /** Its place among its agent's queued runs, in claim order (1 first). */
+    readonly agentPosition: number;
+    /** When a delayed run may be claimed. */
+    readonly until: string | null;
+    /**
+     * For `toolUnavailable`: the agent's default coding tool (its first entry's); any of its tools would do. For
+     * `toolSlotsFull`: the first of the agent's tools the free runners run, all of whose slots are taken.
+     */
+    readonly tool: AgentTool | null;
+    /** For `missingFeatures`: what no fitting runner has. */
+    readonly missing: readonly RunnerFeature[];
+    /** For `setupRetrying`: why preparing it failed. */
+    readonly detail: string | null;
+    /** For `secretsNotAllowed`: the variables that ask for a team runner, by scope; absent when not provided. */
+    readonly variables?: readonly VariableRef[];
+    /** What its words need (`RunWaitParams`); absent when nothing, or from a server before they were sent. */
+    readonly params?: RunWaitParams;
+}
+/** The newest thing a held run reported, for a one-line "last activity". */
+export interface RunActivity {
+    readonly at: string;
+    readonly type: RunEventType;
+    readonly tool: string | null;
+    /** Its text, cut to `RUN_ACTIVITY_TEXT_MAX` characters; null when it has none. */
+    readonly text: string | null;
+}
+export declare const RUN_ACTIVITY_TEXT_MAX = 200;
+/** An open run with what a board of work shows about it. */
+export interface WorkloadRun extends Run {
+    /** The newest input's `payload.trigger`, what the subject says woke the agent; null without one. */
+    readonly trigger: string | null;
+    /** The runner holding it. */
+    readonly runnerName: string | null;
+    /** For a held run: the newest text, tool call, status or error it reported. */
+    readonly lastActivity: RunActivity | null;
+    /** For a queued run: why it waits. */
+    readonly wait: RunWait | null;
+}
+/** An agent's load: its runs held and queued, the most it may hold, and whether a runner could take its work now. */
+export interface AgentLoad {
+    readonly agentId: string;
+    readonly active: number;
+    readonly queued: number;
+    readonly maxConcurrentRuns: number;
+    readonly online: boolean;
+}
+/** The runners as a whole: how many are online, how many of those hold work, and their slots. */
+export interface RunnerLoad {
+    readonly online: number;
+    readonly busy: number;
+    readonly slots: number;
+    readonly used: number;
+}
+/** The open runs on one kind of subject, with the queue explained (`RunService.workload`). */
+export interface Workload {
+    /** Held runs first, then queued in claim order. */
+    readonly runs: readonly WorkloadRun[];
+    /** More runs are open than the limit allowed. */
+    readonly truncated: boolean;
+    /** Every agent that is not archived, and any archived one with an open run here. */
+    readonly agents: readonly AgentLoad[];
+    readonly runners: RunnerLoad;
+}
+export interface WorkloadQuery {
+    readonly subjectKind: string;
+    /** At most this many runs (200 by default, at most 1000). */
+    readonly limit?: number;
+}
+/**
+ * What a run request can be: `pending` until the responsible confirms it (`confirmed`, queued as them) or rejects it
+ * (`rejected`), the requester withdraws it (`withdrawn`, also when they run it as themselves), it is handed to a new
+ * responsible (`superseded`), or nobody settles it in time (`expired`). Only a pending request changes.
+ */
+export declare const RUN_REQUEST_STATUSES: readonly ["pending", "confirmed", "rejected", "withdrawn", "expired", "superseded"];
+export type RunRequestStatus = (typeof RUN_REQUEST_STATUSES)[number];
+/** How work someone asks of an agent is run (`EnqueueRequest.execution`). */
+export declare const RUN_EXECUTIONS: readonly ["auto", "mine"];
+/**
+ * `auto`: as the subject's responsible, once they confirm it when someone else asked; `mine`: as the person who asked,
+ * at once, on a runner they may use (their own, or a team runner).
+ */
+export type RunExecution = (typeof RUN_EXECUTIONS)[number];
+/** The input of a run request, as it was when asked: what confirming it runs. */
+export interface RunRequestInput {
+    readonly type: RunInputType;
+    readonly actor: {
+        readonly kind: ActorKind;
+        readonly id: string;
+        readonly name: string;
+    };
+    readonly text: string;
+    readonly payload: unknown;
+}
+/**
+ * Work someone asked of an agent on a subject another person answers for (its responsible: an issue's owner, say). It
+ * runs only once the responsible confirms it, as them, or when the person who asked runs it as themselves.
+ */
+export interface RunRequest {
+    readonly id: string;
+    readonly agentId: string;
+    readonly subject: {
+        readonly kind: string;
+        readonly id: string;
+    };
+    readonly threadScope: string;
+    /** The run was asked to start a new session; absent on older servers. */
+    readonly freshSession?: boolean;
+    /** Who answers for the subject: the only person who may confirm or reject the request. */
+    readonly responsibleUserId: string;
+    /** Who the chain of work started with: the only person who may withdraw it or run it as themselves. */
+    readonly requestedByUserId: string;
+    readonly ownerUserId: string | null;
+    /** The moment the work was not to be claimed before (`EnqueueRequest.fireAt`); null for as soon as it runs. */
+    readonly fireAt: string | null;
+    /** Attempts its run may take; null for the agent's default. */
+    readonly maxAttempts: number | null;
+    readonly input: RunRequestInput;
+    readonly status: RunRequestStatus;
+    /** Who settled it (confirmed, rejected, withdrew or handed it on); null while pending, and when it expired. */
+    readonly settledById: string | null;
+    readonly settledAt: string | null;
+    /** Why it was rejected or handed on, when someone said. */
+    readonly note: string | null;
+    readonly expiresAt: string;
+    /** The run it went into: on confirming, or when the requester ran it as themselves. */
+    readonly runId: string | null;
+    /** The request that took over when the subject's responsible changed. */
+    readonly supersededById: string | null;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+/** A run request as people's lists show it: with the names of its agent and of the people in it. */
+export interface RunRequestItem extends RunRequest {
+    /** Null when the agent was deleted. */
+    readonly agentName: string | null;
+    readonly responsibleName: string | null;
+    readonly requestedByName: string | null;
+}
+/** A subject and agent with at least one dispatched or running run; no run details. */
+export interface SubjectAgentWork {
+    readonly subjectId: string;
+    readonly agentId: string;
+    readonly working: boolean;
+}
+//# sourceMappingURL=runs.d.ts.map

package/dist/shared/runs.d.ts.map

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

package/dist/shared/runs.js

@@ -0,0 +1,65 @@
+/** The run subject kind of a consultation: an online agent asking another a question (`ask_agent`). */
+export const CONSULTATION_SUBJECT = 'consultation';
+/** How deep consultations go: the agent asked may ask another, which may not ask further. */
+export const CONSULT_MAX_DEPTH = 2;
+/**
+ * Why a queued run has not been taken yet, as far as the claim's own rules tell (`RunService.workload`), checked in
+ * this order:
+ *
+ * - `agentArchived`: its agent is archived or gone; the sweeper cancels it.
+ * - `delayed`: it was given a moment (`fireAt`, or a retry's backoff) that has not come; `until` says when.
+ * - `noRunnerOnline`: no runner is online at all.
+ * - `runnersOffline`: the agent names its runners, and none of them is online.
+ * - `toolUnavailable`: runners are online, but none has any of the agent's coding tools enabled, installed and
+ *   signed in.
+ * - `noSharedRunner`: only personal runners could take it, and none belongs to the person who woke the agent.
+ * - `missingFeatures`: the runners that could take it lack what it needs (`missing`).
+ * - `secretsNotAllowed`: some of its variables are for team runners only (`variables` names them), and the runners
+ *   that could take it are personal ones.
+ * - `sameWorkActive`: the agent is already working on the same subject and thread; this run follows.
+ * - `concurrencyFull`: the agent has as many runs held as it may have at once.
+ * - `runnersBusy`: every runner that could take it has its slots full (the machine's slots).
+ * - `toolSlotsFull`: a runner that could take it has a free slot, but none has room for any of the agent's coding tools
+ *   (`Runner.toolSlots`); `tool` names the one that is full.
+ * - `setupRetrying`: preparing it failed and is tried again (`detail` says why).
+ * - `next`: nothing holds it; the next free runner that asks takes it.
+ */
+export const RUN_WAIT_REASONS = [
+    'updatePending',
+    'pruning',
+    'agentArchived',
+    'incompatible',
+    'toolNotInstalled',
+    'restricted',
+    'unknown',
+    'delayed',
+    'noRunnerOnline',
+    'runnersOffline',
+    'toolUnavailable',
+    'noSharedRunner',
+    'missingFeatures',
+    'secretsNotAllowed',
+    'sameWorkActive',
+    'concurrencyFull',
+    'runnersBusy',
+    'toolSlotsFull',
+    'setupRetrying',
+    'next',
+];
+export const RUN_ACTIVITY_TEXT_MAX = 200;
+/**
+ * What a run request can be: `pending` until the responsible confirms it (`confirmed`, queued as them) or rejects it
+ * (`rejected`), the requester withdraws it (`withdrawn`, also when they run it as themselves), it is handed to a new
+ * responsible (`superseded`), or nobody settles it in time (`expired`). Only a pending request changes.
+ */
+export const RUN_REQUEST_STATUSES = [
+    'pending',
+    'confirmed',
+    'rejected',
+    'withdrawn',
+    'expired',
+    'superseded',
+];
+/** How work someone asks of an agent is run (`EnqueueRequest.execution`). */
+export const RUN_EXECUTIONS = ['auto', 'mine'];
+//# sourceMappingURL=runs.js.map

package/dist/shared/runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../shared/runs.ts"],"names":[],"mappings":"AAgBA,uGAAuG;AACvG,MAAM,CAAC,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAEnD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAyOnC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,eAAe;IACf,SAAS;IACT,eAAe;IACf,cAAc;IACd,kBAAkB;IAClB,YAAY;IACZ,SAAS;IACT,SAAS;IACT,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,gBAAgB;IAChB,iBAAiB;IACjB,mBAAmB;IACnB,gBAAgB;IAChB,iBAAiB;IACjB,aAAa;IACb,eAAe;IACf,eAAe;IACf,MAAM;CACE,CAAC;AAsDX,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAgDzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS;IACT,WAAW;IACX,UAAU;IACV,WAAW;IACX,SAAS;IACT,YAAY;CACJ,CAAC;AAIX,6EAA6E;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC"}

package/dist/shared/skill-markdown.d.ts

@@ -0,0 +1,45 @@
+export declare const SKILL_NAME_MAX: number;
+export declare const SKILL_DESCRIPTION_MAX: number;
+export declare const SKILL_COMPATIBILITY_MAX: number;
+export type SkillFrontMatterField = 'frontMatter' | 'name' | 'description' | 'license' | 'compatibility' | 'metadata' | 'allowed-tools';
+/**
+ * - `missing`: no front matter; `yaml`: it is not valid YAML; `notMapping`: it is not a mapping of keys.
+ * - `required`, `empty`, `type`, `tooLong`: a value is absent, blank, not of its type, or over its length.
+ * - `pattern`: a name other than lower-case words joined by single hyphens.
+ * - `mismatch`: a name other than the folder an archive holds the skill in; `taken`: another skill's name.
+ */
+export type SkillFrontMatterReason = 'missing' | 'yaml' | 'notMapping' | 'required' | 'empty' | 'type' | 'tooLong' | 'pattern' | 'mismatch' | 'taken';
+export interface SkillFrontMatterProblem {
+    readonly field: SkillFrontMatterField;
+    readonly reason: SkillFrontMatterReason;
+    /** In English, for the API and the logs; the browser words it from `field` and `reason`. */
+    readonly message: string;
+    /** The longest value allowed, for `tooLong`. */
+    readonly max?: number;
+}
+export interface SkillFrontMatter {
+    readonly name: string;
+    readonly description: string;
+    readonly license?: string;
+    /** What the skill needs of its environment, such as a product or network access. */
+    readonly compatibility?: string;
+    readonly metadata?: Readonly<Record<string, string>>;
+    /** `allowed-tools`: space-separated tools the skill may use. */
+    readonly allowedTools?: string;
+}
+export interface ParsedSkillMarkdown {
+    /** The valid values found; `name` and `description` only when they are valid. */
+    readonly frontMatter: Partial<SkillFrontMatter>;
+    /** What follows the front matter (the whole text when there is none). */
+    readonly body: string;
+    readonly problems: readonly SkillFrontMatterProblem[];
+}
+/** Why `name` cannot name a skill, or null. */
+export declare function skillNameProblem(name: unknown): SkillFrontMatterProblem | null;
+/** Splits `SKILL.md` into its front matter and body and checks the front matter against the specification. */
+export declare function parseSkillMarkdown(markdown: string): ParsedSkillMarkdown;
+/** `SKILL.md` of front matter (keys in the order given, undefined ones left out) and a body. */
+export declare function composeSkillMarkdown(frontMatter: Readonly<Record<string, unknown>>, body: string): string;
+/** The first problem of each field, for showing beside what it concerns. */
+export declare function problemsByField(problems: readonly SkillFrontMatterProblem[]): ReadonlyMap<SkillFrontMatterField, SkillFrontMatterProblem>;
+//# sourceMappingURL=skill-markdown.d.ts.map

package/dist/shared/skill-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-markdown.d.ts","sourceRoot":"","sources":["../../shared/skill-markdown.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,cAAc,EAAE,MAAW,CAAC;AACzC,eAAO,MAAM,qBAAqB,EAAE,MAAa,CAAC;AAClD,eAAO,MAAM,uBAAuB,EAAE,MAAY,CAAC;AAOnD,MAAM,MAAM,qBAAqB,GAC7B,aAAa,GACb,MAAM,GACN,aAAa,GACb,SAAS,GACT,eAAe,GACf,UAAU,GACV,eAAe,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAC9B,SAAS,GACT,MAAM,GACN,YAAY,GACZ,UAAU,GACV,OAAO,GACP,MAAM,GACN,SAAS,GACT,SAAS,GACT,UAAU,GACV,OAAO,CAAC;AAEZ,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,oFAAoF;IACpF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,gEAAgE;IAChE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAChD,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACvD;AAWD,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,OAAO,GACZ,uBAAuB,GAAG,IAAI,CAqBhC;AAsBD,8GAA8G;AAC9G,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAsHxE;AAED,gGAAgG;AAChG,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC9C,IAAI,EAAE,MAAM,GACX,MAAM,CAMR;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,uBAAuB,EAAE,GAC3C,WAAW,CAAC,qBAAqB,EAAE,uBAAuB,CAAC,CAK7D"}