@kitman-sh/sdk 0.10.82 → 0.10.84

package/types/packages/core/src/intent.d.ts

@@ -0,0 +1,260 @@
+import * as Schema from 'effect/Schema';
+export declare const RunIntentConstraint: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly text: Schema.String;
+    readonly kind: Schema.Union<readonly [Schema.Literal<"rule">, Schema.Literal<"semantic">]>;
+    readonly severity: Schema.Union<readonly [Schema.Literal<"block">, Schema.Literal<"warn">]>;
+    readonly source: Schema.Union<readonly [Schema.Literal<"launch">, Schema.Literal<"repository">, Schema.Literal<"plan">, Schema.Literal<"parent">, Schema.Literal<"human">]>;
+    readonly rule: Schema.optionalKey<Schema.Struct<{
+        readonly kind: Schema.Literal<"protected_paths">;
+        readonly globs: Schema.$Array<Schema.String>;
+    }>>;
+}>;
+export type RunIntentConstraint = (typeof RunIntentConstraint)['Type'];
+/** One version of a Run's Intent, with what changed and who changed it. */
+export declare const RunIntentVersion: Schema.Struct<{
+    readonly version: Schema.Int;
+    readonly goal: Schema.String;
+    readonly doneWhen: Schema.$Array<Schema.String>;
+    readonly constraints: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly text: Schema.String;
+        readonly kind: Schema.Union<readonly [Schema.Literal<"rule">, Schema.Literal<"semantic">]>;
+        readonly severity: Schema.Union<readonly [Schema.Literal<"block">, Schema.Literal<"warn">]>;
+        readonly source: Schema.Union<readonly [Schema.Literal<"launch">, Schema.Literal<"repository">, Schema.Literal<"plan">, Schema.Literal<"parent">, Schema.Literal<"human">]>;
+        readonly rule: Schema.optionalKey<Schema.Struct<{
+            readonly kind: Schema.Literal<"protected_paths">;
+            readonly globs: Schema.$Array<Schema.String>;
+        }>>;
+    }>>;
+    readonly corrections: Schema.Boolean;
+    readonly removedConstraintIds: Schema.$Array<Schema.String>;
+    readonly change: Schema.String;
+    readonly author: Schema.Struct<{
+        readonly actorType: Schema.String;
+        readonly actorId: Schema.String;
+    }>;
+    readonly createdAt: Schema.String;
+}>;
+export type RunIntentVersion = (typeof RunIntentVersion)['Type'];
+/** What a Run is held to: its current Intent and every version, oldest first. */
+export declare const RunIntent: Schema.Struct<{
+    readonly runId: Schema.String;
+    readonly current: Schema.optionalKey<Schema.Struct<{
+        readonly version: Schema.Int;
+        readonly goal: Schema.String;
+        readonly doneWhen: Schema.$Array<Schema.String>;
+        readonly constraints: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly text: Schema.String;
+            readonly kind: Schema.Union<readonly [Schema.Literal<"rule">, Schema.Literal<"semantic">]>;
+            readonly severity: Schema.Union<readonly [Schema.Literal<"block">, Schema.Literal<"warn">]>;
+            readonly source: Schema.Union<readonly [Schema.Literal<"launch">, Schema.Literal<"repository">, Schema.Literal<"plan">, Schema.Literal<"parent">, Schema.Literal<"human">]>;
+            readonly rule: Schema.optionalKey<Schema.Struct<{
+                readonly kind: Schema.Literal<"protected_paths">;
+                readonly globs: Schema.$Array<Schema.String>;
+            }>>;
+        }>>;
+        readonly corrections: Schema.Boolean;
+        readonly removedConstraintIds: Schema.$Array<Schema.String>;
+        readonly change: Schema.String;
+        readonly author: Schema.Struct<{
+            readonly actorType: Schema.String;
+            readonly actorId: Schema.String;
+        }>;
+        readonly createdAt: Schema.String;
+    }>>;
+    readonly versions: Schema.$Array<Schema.Struct<{
+        readonly version: Schema.Int;
+        readonly goal: Schema.String;
+        readonly doneWhen: Schema.$Array<Schema.String>;
+        readonly constraints: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly text: Schema.String;
+            readonly kind: Schema.Union<readonly [Schema.Literal<"rule">, Schema.Literal<"semantic">]>;
+            readonly severity: Schema.Union<readonly [Schema.Literal<"block">, Schema.Literal<"warn">]>;
+            readonly source: Schema.Union<readonly [Schema.Literal<"launch">, Schema.Literal<"repository">, Schema.Literal<"plan">, Schema.Literal<"parent">, Schema.Literal<"human">]>;
+            readonly rule: Schema.optionalKey<Schema.Struct<{
+                readonly kind: Schema.Literal<"protected_paths">;
+                readonly globs: Schema.$Array<Schema.String>;
+            }>>;
+        }>>;
+        readonly corrections: Schema.Boolean;
+        readonly removedConstraintIds: Schema.$Array<Schema.String>;
+        readonly change: Schema.String;
+        readonly author: Schema.Struct<{
+            readonly actorType: Schema.String;
+            readonly actorId: Schema.String;
+        }>;
+        readonly createdAt: Schema.String;
+    }>>;
+}>;
+export type RunIntent = (typeof RunIntent)['Type'];
+export declare const RunIntentAmend: Schema.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.Literal<"set_goal">;
+    readonly goal: Schema.String;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"add_constraint">;
+    /** `rule:protected_paths:<glob>[,<glob>…]` spells a rule; any other text is semantic. */
+    readonly constraint: Schema.String;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"remove_constraint">;
+    readonly id: Schema.String;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"set_corrections">;
+    readonly on: Schema.Boolean;
+}>]>;
+export type RunIntentAmend = (typeof RunIntentAmend)['Type'];
+/** A constraint every Run on a repository starts with, as a person spelled it. */
+export declare const StandingConstraint: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly repoBindingId: Schema.String;
+    readonly text: Schema.String;
+    readonly addedByUserId: Schema.String;
+    readonly createdAt: Schema.String;
+}>;
+export type StandingConstraint = (typeof StandingConstraint)['Type'];
+export declare const StandingConstraintList: Schema.Struct<{
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly repoBindingId: Schema.String;
+        readonly text: Schema.String;
+        readonly addedByUserId: Schema.String;
+        readonly createdAt: Schema.String;
+    }>>;
+}>;
+export type StandingConstraintList = (typeof StandingConstraintList)['Type'];
+export declare const StandingConstraintAdd: Schema.Struct<{
+    /** `rule:protected_paths:<glob>[,<glob>…]` spells a rule; any other text is semantic. */
+    readonly text: Schema.String;
+}>;
+export type StandingConstraintAdd = (typeof StandingConstraintAdd)['Type'];
+export declare const DriftResolution: Schema.Struct<{
+    readonly status: Schema.Literals<readonly ["open", "correction_sent", "escalated", "verified", "dismissed"]>;
+    readonly intentVersion: Schema.Int;
+    readonly at: Schema.String;
+    readonly reason: Schema.optionalKey<Schema.String>;
+    readonly actor: Schema.optionalKey<Schema.Struct<{
+        readonly actorType: Schema.String;
+        readonly actorId: Schema.String;
+    }>>;
+}>;
+/** What a check found against one of the Run's constraints, and its resolutions, oldest first. */
+export declare const DriftReport: Schema.Struct<{
+    readonly constraintId: Schema.String;
+    readonly constraintText: Schema.String;
+    readonly kind: Schema.Union<readonly [Schema.Literal<"rule">, Schema.Literal<"semantic">]>;
+    readonly severity: Schema.Union<readonly [Schema.Literal<"block">, Schema.Literal<"warn">]>;
+    readonly intentVersion: Schema.Int;
+    readonly citedPaths: Schema.$Array<Schema.String>;
+    readonly truncated: Schema.Boolean;
+    readonly status: Schema.Literals<readonly ["open", "correction_sent", "escalated", "verified", "dismissed"]>;
+    readonly history: Schema.$Array<Schema.Struct<{
+        readonly status: Schema.Literals<readonly ["open", "correction_sent", "escalated", "verified", "dismissed"]>;
+        readonly intentVersion: Schema.Int;
+        readonly at: Schema.String;
+        readonly reason: Schema.optionalKey<Schema.String>;
+        readonly actor: Schema.optionalKey<Schema.Struct<{
+            readonly actorType: Schema.String;
+            readonly actorId: Schema.String;
+        }>>;
+    }>>;
+}>;
+export type DriftReport = (typeof DriftReport)['Type'];
+/** An accepted agent Step's boundary: what evidence it had, and why its rules went unchecked if they did. */
+export declare const RunBoundary: Schema.Struct<{
+    readonly stepAttemptId: Schema.String;
+    readonly stepKey: Schema.String;
+    readonly intentVersion: Schema.optionalKey<Schema.Int>;
+    readonly evidence: Schema.optionalKey<Schema.Struct<{
+        readonly kind: Schema.Union<readonly [Schema.Literal<"change">, Schema.Literal<"output">]>;
+        readonly changedPaths: Schema.optionalKey<Schema.$Array<Schema.String>>;
+        readonly truncated: Schema.Boolean;
+    }>>;
+    readonly uncheckedReason: Schema.optionalKey<Schema.String>;
+    readonly createdAt: Schema.String;
+}>;
+export type RunBoundary = (typeof RunBoundary)['Type'];
+/** A `judge` StepAttempt's verdicts on the Run's semantic constraints, and at the finish its goal and doneWhen. */
+export declare const RunJudgement: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly final: Schema.Boolean;
+    readonly status: Schema.Literals<readonly ["queued", "running", "judged", "skipped"]>;
+    readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+    readonly intentVersion: Schema.optionalKey<Schema.Int>;
+    readonly constraints: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+        readonly constraintId: Schema.String;
+        readonly verdict: Schema.Literals<readonly ["holds", "breached", "unverified"]>;
+        readonly citations: Schema.$Array<Schema.Struct<{
+            readonly path: Schema.String;
+            readonly line: Schema.optionalKey<Schema.Int>;
+        }>>;
+    }>>>;
+    readonly goal: Schema.optionalKey<Schema.Literals<readonly ["met", "not_met", "unverified"]>>;
+    readonly doneWhen: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["met", "not_met", "unverified"]>>>;
+    readonly skipReason: Schema.optionalKey<Schema.String>;
+    readonly createdAt: Schema.String;
+    readonly settledAt: Schema.optionalKey<Schema.String>;
+}>;
+export type RunJudgement = (typeof RunJudgement)['Type'];
+export declare const RunDrift: Schema.Struct<{
+    readonly runId: Schema.String;
+    readonly reports: Schema.$Array<Schema.Struct<{
+        readonly constraintId: Schema.String;
+        readonly constraintText: Schema.String;
+        readonly kind: Schema.Union<readonly [Schema.Literal<"rule">, Schema.Literal<"semantic">]>;
+        readonly severity: Schema.Union<readonly [Schema.Literal<"block">, Schema.Literal<"warn">]>;
+        readonly intentVersion: Schema.Int;
+        readonly citedPaths: Schema.$Array<Schema.String>;
+        readonly truncated: Schema.Boolean;
+        readonly status: Schema.Literals<readonly ["open", "correction_sent", "escalated", "verified", "dismissed"]>;
+        readonly history: Schema.$Array<Schema.Struct<{
+            readonly status: Schema.Literals<readonly ["open", "correction_sent", "escalated", "verified", "dismissed"]>;
+            readonly intentVersion: Schema.Int;
+            readonly at: Schema.String;
+            readonly reason: Schema.optionalKey<Schema.String>;
+            readonly actor: Schema.optionalKey<Schema.Struct<{
+                readonly actorType: Schema.String;
+                readonly actorId: Schema.String;
+            }>>;
+        }>>;
+    }>>;
+    readonly boundaries: Schema.$Array<Schema.Struct<{
+        readonly stepAttemptId: Schema.String;
+        readonly stepKey: Schema.String;
+        readonly intentVersion: Schema.optionalKey<Schema.Int>;
+        readonly evidence: Schema.optionalKey<Schema.Struct<{
+            readonly kind: Schema.Union<readonly [Schema.Literal<"change">, Schema.Literal<"output">]>;
+            readonly changedPaths: Schema.optionalKey<Schema.$Array<Schema.String>>;
+            readonly truncated: Schema.Boolean;
+        }>>;
+        readonly uncheckedReason: Schema.optionalKey<Schema.String>;
+        readonly createdAt: Schema.String;
+    }>>;
+    /** Oldest first. */
+    readonly judgements: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly final: Schema.Boolean;
+        readonly status: Schema.Literals<readonly ["queued", "running", "judged", "skipped"]>;
+        readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+        readonly intentVersion: Schema.optionalKey<Schema.Int>;
+        readonly constraints: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly constraintId: Schema.String;
+            readonly verdict: Schema.Literals<readonly ["holds", "breached", "unverified"]>;
+            readonly citations: Schema.$Array<Schema.Struct<{
+                readonly path: Schema.String;
+                readonly line: Schema.optionalKey<Schema.Int>;
+            }>>;
+        }>>>;
+        readonly goal: Schema.optionalKey<Schema.Literals<readonly ["met", "not_met", "unverified"]>>;
+        readonly doneWhen: Schema.optionalKey<Schema.$Array<Schema.Literals<readonly ["met", "not_met", "unverified"]>>>;
+        readonly skipReason: Schema.optionalKey<Schema.String>;
+        readonly createdAt: Schema.String;
+        readonly settledAt: Schema.optionalKey<Schema.String>;
+    }>>;
+}>;
+export type RunDrift = (typeof RunDrift)['Type'];
+export declare const RunDriftDismiss: Schema.Struct<{
+    readonly reason: Schema.String;
+}>;
+export type RunDriftDismiss = (typeof RunDriftDismiss)['Type'];

package/types/packages/core/src/kit-install.d.ts

@@ -0,0 +1,130 @@
+import * as Schema from 'effect/Schema';
+/** A Kit installed from npm on the Workspace, a Team, or one person. */
+export declare const KitInstall: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly owner: Schema.Literals<readonly ["workspace", "team", "personal"]>;
+    readonly teamId: Schema.optionalKey<Schema.String>;
+    /** Absent for an install carried over from the old Kit model until a Run or a check first resolves it. */
+    readonly version: Schema.optionalKey<Schema.String>;
+    /** It follows npm `latest` without one. */
+    readonly pinnedVersion: Schema.optionalKey<Schema.String>;
+    readonly lastCheckedAt: Schema.optionalKey<Schema.String>;
+    /** Why its last check left it at `version`. */
+    readonly problem: Schema.optionalKey<Schema.String>;
+    /** The person its Loops' automatic starts act for; with nobody, they start only once someone Adds it again. */
+    readonly actsFor: Schema.optionalKey<Schema.String>;
+}>;
+export type KitInstall = typeof KitInstall.Type;
+export declare const KitInstallList: Schema.Struct<{
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly owner: Schema.Literals<readonly ["workspace", "team", "personal"]>;
+        readonly teamId: Schema.optionalKey<Schema.String>;
+        /** Absent for an install carried over from the old Kit model until a Run or a check first resolves it. */
+        readonly version: Schema.optionalKey<Schema.String>;
+        /** It follows npm `latest` without one. */
+        readonly pinnedVersion: Schema.optionalKey<Schema.String>;
+        readonly lastCheckedAt: Schema.optionalKey<Schema.String>;
+        /** Why its last check left it at `version`. */
+        readonly problem: Schema.optionalKey<Schema.String>;
+        /** The person its Loops' automatic starts act for; with nobody, they start only once someone Adds it again. */
+        readonly actsFor: Schema.optionalKey<Schema.String>;
+    }>>;
+}>;
+export type KitInstallList = typeof KitInstallList.Type;
+/** Installs on the Workspace, the Team `teamId` names, or, with `me`, the caller. */
+export declare const KitOwnerQuery: Schema.Struct<{
+    readonly teamId: Schema.optionalKey<Schema.String>;
+    readonly me: Schema.optionalKey<Schema.Literals<readonly ["true", "false"]>>;
+}>;
+export declare const KitAddRequest: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly teamId: Schema.optionalKey<Schema.String>;
+    readonly me: Schema.optionalKey<Schema.Boolean>;
+}>;
+export type KitAddRequest = typeof KitAddRequest.Type;
+export declare const KitPinRequest: Schema.Struct<{
+    readonly version: Schema.String;
+}>;
+/** The Kits a person's machines get, nearest first: their own, their Teams', the Workspace's, then Kitman's. */
+export declare const KitChain: Schema.Struct<{
+    readonly kits: Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly version: Schema.String;
+        readonly setupDigest: Schema.String;
+    }>>;
+    /** Installs with no version to sync, and why. */
+    readonly skipped: Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly problem: Schema.String;
+    }>>;
+}>;
+export type KitChain = typeof KitChain.Type;
+/** The Kits of an Owner chain, nearest first, each deployed or installed. */
+export declare const OwnerKits: Schema.Struct<{
+    readonly kits: Schema.$Array<Schema.Struct<{
+        readonly name: Schema.String;
+        readonly version: Schema.String;
+        readonly source: Schema.Literals<readonly ["deployed", "installed"]>;
+    }>>;
+}>;
+export type OwnerKits = typeof OwnerKits.Type;
+export declare const OwnerKitsQuery: Schema.Struct<{
+    readonly teamId: Schema.optionalKey<Schema.String>;
+}>;
+/** A setup archive's JSON text, whose sha256 is its digest. */
+export declare const KitSetupDownload: Schema.Struct<{
+    readonly archive: Schema.String;
+}>;
+export type KitSetupDownload = typeof KitSetupDownload.Type;
+export declare const KitPreviewQuery: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly version: Schema.optionalKey<Schema.String>;
+}>;
+/** What a Kit brings, from its published build, before it is added. */
+export declare const KitPreview: Schema.Struct<{
+    readonly name: Schema.String;
+    readonly version: Schema.String;
+    readonly loops: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly title: Schema.String;
+        readonly when: Schema.$Array<Schema.Struct<{
+            readonly event: Schema.String;
+            readonly filter: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Null]>, Schema.$Array<Schema.Union<readonly [Schema.String, Schema.Finite, Schema.Boolean, Schema.Null]>>]>>>;
+            readonly input: Schema.$Record<Schema.String, Schema.String>;
+            readonly values: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+        }>>;
+    }>>;
+    readonly agents: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+    }>>;
+    readonly skills: Schema.$Array<Schema.Struct<{
+        readonly kit: Schema.String;
+        readonly name: Schema.String;
+    }>>;
+    readonly plugins: Schema.$Array<Schema.Struct<{
+        readonly kit: Schema.String;
+        readonly name: Schema.String;
+        readonly hooks: Schema.$Array<Schema.String>;
+    }>>;
+    readonly mcpServers: Schema.$Array<Schema.Struct<{
+        readonly kit: Schema.String;
+        readonly name: Schema.String;
+        /** A remote server's host; a stdio server runs `command` instead. */
+        readonly host: Schema.optionalKey<Schema.String>;
+        readonly command: Schema.optionalKey<Schema.String>;
+    }>>;
+    /** The Secrets its MCP config names by `{env:NAME}`. */
+    readonly secrets: Schema.$Array<Schema.String>;
+}>;
+export type KitPreview = typeof KitPreview.Type;
+/** A published Kit's preview; declarations or archives that don't decode contribute nothing. */
+export declare const kitPreview: (kit: {
+    readonly name: string;
+    readonly version: string;
+    readonly declarations: unknown;
+    readonly setupArchives: readonly {
+        readonly digest: string;
+        readonly archive: Uint8Array;
+    }[];
+}) => KitPreview;