@kitman-sh/sdk 0.9.0 → 0.10.53

package/types/packages/core/src/loop-layers.d.ts

@@ -1,4 +1,5 @@
 import type { AgentSandboxNetwork } from './agent-sandbox-policy';
+import type { AgentFallback } from './loop';
 /** Where a Loop or Agent version lives, nearest first. */
 export declare const LoopLayers: readonly ['team', 'workspace', 'shipped'];
 export type LoopLayer = (typeof LoopLayers)[number];
@@ -16,15 +17,28 @@ export declare const resolveLayered: <T extends {
 } | undefined;
 export declare const AgentEfforts: readonly ['low', 'medium', 'high', 'xhigh'];
 export type AgentEffort = (typeof AgentEfforts)[number];
+/** Tools an Agent opts into beyond the base set; each Harness applies what it can. */
+export declare const AgentCapabilities: readonly ['web', 'subagents', 'artifacts', 'browser'];
+export type AgentCapability = (typeof AgentCapabilities)[number];
 /** Whether a harness has an effort control; a StepAttempt on any other harness records its effort as ignored. */
 export declare const harnessTakesEffort: (harness: string) => boolean;
-/** The fields an Agent version may name; one that extends another replaces these, and merges instructions by section. */
+/** One way to launch a Step; with no Harness it needs the claiming Runner's default. */
+export type AgentChoice = Partial<AgentFallback>;
+/**
+ * The fields an Agent version may name; one that extends another replaces these, and merges instructions by section.
+ * One that names a Harness and no model drops the inherited model.
+ */
 export type AgentFields = {
     readonly instructions?: string;
     readonly harness?: string;
     readonly model?: string;
     readonly effort?: AgentEffort;
-    readonly kits?: readonly string[];
+    /** Tried in order when a Runner does not offer the Agent's own Harness. */
+    readonly fallbacks?: readonly AgentFallback[];
+    /** The tool capabilities its Steps get beyond the base tools. */
+    readonly tools?: readonly AgentCapability[];
+    /** The skills its Steps list; the Run's other Kit skills are loaded by name. */
+    readonly skills?: readonly string[];
     readonly network?: AgentSandboxNetwork;
     /** The SandboxBackend its Steps require. */
     readonly sandbox?: 'docker';
@@ -32,8 +46,8 @@ export type AgentFields = {
 export type AgentListing = AgentFields & {
     readonly id: string;
     readonly extends?: string;
-    /** The Package that declares it. */
-    readonly package?: string;
+    /** The Kit that declares it. */
+    readonly kit?: string;
 };
 export type ResolvedAgent = AgentFields & {
     readonly id: string;
@@ -41,6 +55,21 @@ export type ResolvedAgent = AgentFields & {
 export type AgentFieldLayers = {
     readonly [field in keyof AgentFields]?: LoopLayer;
 };
+/** The ways to launch an Agent's Step, in order: its own, then each fallback. */
+export declare const agentChoices: (agent: (AgentChoice & Pick<AgentFields, 'fallbacks'>) | undefined) => readonly AgentChoice[];
+/** A launch's choices; one launched before Agents had fallbacks has its own fields as its only choice. */
+export declare const launchChoices: (launch: AgentChoice & {
+    readonly choices?: readonly AgentChoice[];
+}) => readonly AgentChoice[];
+/** What a Step launches on until a Runner claims it. */
+export declare const firstChoice: (choices: readonly AgentChoice[]) => AgentChoice;
+/** The fields a launch takes from its choice. */
+export declare const choiceLaunch: (choice: AgentChoice) => {
+    effortIgnored?: true;
+    harness?: string;
+    model?: string;
+    effort?: "high" | "low" | "medium" | "xhigh";
+};
 /**
  * Merges an extending Agent's instructions into its parent's by `## ` heading: a named section replaces the parent's,
  * a new one is appended, and text before the first heading replaces the parent's.