@kitman-sh/sdk 0.7.0 → 0.7.2

package/types/packages/core/src/scope-directory.d.ts

@@ -1,100 +0,0 @@
-import * as Schema from 'effect/Schema';
-export declare const ScopeDirectoryPageSize = 50;
-export declare const ScopeDirectoryPageSizeMaximum = 100;
-export declare const ScopeDirectoryIncludedMaximum = 8;
-export declare const ScopeDirectoryIdMaximum = 128;
-export declare const ScopeDirectoryCursorMaximum = 512;
-export declare const ScopeDirectoryId: Schema.String;
-export declare const WorkspaceSelectorItem: Schema.Struct<{
-    readonly id: Schema.String;
-    readonly name: Schema.String;
-}>;
-export declare const ProjectSelectorItem: Schema.Struct<{
-    readonly id: Schema.String;
-    readonly workspaceId: Schema.String;
-    readonly name: Schema.String;
-}>;
-export declare const ScopeDirectoryPageInfo: Schema.Union<readonly [Schema.Struct<{
-    readonly hasNextPage: Schema.Literal<false>;
-}>, Schema.Struct<{
-    readonly hasNextPage: Schema.Literal<true>;
-    readonly endCursor: Schema.String;
-}>]>;
-export declare const WorkspaceSelectorPage: Schema.Struct<{
-    readonly items: Schema.$Array<Schema.Struct<{
-        readonly id: Schema.String;
-        readonly name: Schema.String;
-    }>>;
-    readonly included: Schema.$Array<Schema.Struct<{
-        readonly id: Schema.String;
-        readonly name: Schema.String;
-    }>>;
-    readonly pageInfo: Schema.Union<readonly [Schema.Struct<{
-        readonly hasNextPage: Schema.Literal<false>;
-    }>, Schema.Struct<{
-        readonly hasNextPage: Schema.Literal<true>;
-        readonly endCursor: Schema.String;
-    }>]>;
-}>;
-export declare const ProjectSelectorPage: Schema.Struct<{
-    readonly items: Schema.$Array<Schema.Struct<{
-        readonly id: Schema.String;
-        readonly workspaceId: Schema.String;
-        readonly name: Schema.String;
-    }>>;
-    readonly included: Schema.$Array<Schema.Struct<{
-        readonly id: Schema.String;
-        readonly workspaceId: Schema.String;
-        readonly name: Schema.String;
-    }>>;
-    readonly pageInfo: Schema.Union<readonly [Schema.Struct<{
-        readonly hasNextPage: Schema.Literal<false>;
-    }>, Schema.Struct<{
-        readonly hasNextPage: Schema.Literal<true>;
-        readonly endCursor: Schema.String;
-    }>]>;
-}>;
-export declare const ScopeDirectoryPageQuery: Schema.Struct<{
-    readonly limit: Schema.optionalKey<Schema.Union<readonly [Schema.Finite, Schema.FiniteFromString]>>;
-    readonly cursor: Schema.optionalKey<Schema.String>;
-    readonly includeIds: Schema.optionalKey<Schema.String>;
-}>;
-export declare const parseWorkspaceSelectorPage: <ValueType>(value: ValueType) => {
-    readonly items: readonly {
-        readonly id: string;
-        readonly name: string;
-    }[];
-    readonly included: readonly {
-        readonly id: string;
-        readonly name: string;
-    }[];
-    readonly pageInfo: {
-        readonly hasNextPage: false;
-    } | {
-        readonly hasNextPage: true;
-        readonly endCursor: string;
-    };
-};
-export declare const parseProjectSelectorPage: <ValueType>(value: ValueType, workspaceId: string) => {
-    readonly items: readonly {
-        readonly id: string;
-        readonly workspaceId: string;
-        readonly name: string;
-    }[];
-    readonly included: readonly {
-        readonly id: string;
-        readonly workspaceId: string;
-        readonly name: string;
-    }[];
-    readonly pageInfo: {
-        readonly hasNextPage: false;
-    } | {
-        readonly hasNextPage: true;
-        readonly endCursor: string;
-    };
-};
-export type WorkspaceSelectorItem = (typeof WorkspaceSelectorItem)['Type'];
-export type ProjectSelectorItem = (typeof ProjectSelectorItem)['Type'];
-export type WorkspaceSelectorPage = (typeof WorkspaceSelectorPage)['Type'];
-export type ProjectSelectorPage = (typeof ProjectSelectorPage)['Type'];
-export type ScopeDirectoryPageInfo = (typeof ScopeDirectoryPageInfo)['Type'];

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

@@ -1,37 +0,0 @@
-import * as Schema from 'effect/Schema';
-/** A Secret's name, which a Loop reads through Effect `Config`. */
-export declare const SecretName: Schema.String;
-export declare const SecretScope: Schema.Union<readonly [Schema.Literal<"workspace">, Schema.Literal<"project">]>;
-export type SecretScope = (typeof SecretScope)['Type'];
-/** A Secret as anyone may see it: never its value. */
-export declare const SecretSummary: Schema.Struct<{
-    readonly name: Schema.String;
-    readonly scope: Schema.Union<readonly [Schema.Literal<"workspace">, Schema.Literal<"project">]>;
-    readonly projectId: Schema.optionalKey<Schema.String>;
-    readonly setByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
-    readonly setByActorId: Schema.String;
-    readonly setAt: Schema.String;
-}>;
-export type SecretSummary = (typeof SecretSummary)['Type'];
-export declare const SecretList: Schema.Struct<{
-    readonly items: Schema.$Array<Schema.Struct<{
-        readonly name: Schema.String;
-        readonly scope: Schema.Union<readonly [Schema.Literal<"workspace">, Schema.Literal<"project">]>;
-        readonly projectId: Schema.optionalKey<Schema.String>;
-        readonly setByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
-        readonly setByActorId: Schema.String;
-        readonly setAt: Schema.String;
-    }>>;
-}>;
-export type SecretList = (typeof SecretList)['Type'];
-export declare const secretSetRefused = "A Secret takes a value of 1 to 65536 characters and an optional projectId";
-/** Sets a Secret for the Workspace, or for one of its Projects; a refusal never quotes the value. */
-export declare const SecretSet: Schema.Struct<{
-    readonly value: Schema.String;
-    readonly projectId: Schema.optionalKey<Schema.String>;
-}>;
-export type SecretSet = (typeof SecretSet)['Type'];
-export declare const SecretScopeQuery: Schema.Struct<{
-    readonly projectId: Schema.optionalKey<Schema.String>;
-}>;
-export type SecretScopeQuery = (typeof SecretScopeQuery)['Type'];

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

@@ -1,90 +0,0 @@
-import * as Schema from 'effect/Schema';
-export declare const SessionStatuses: readonly ['active', 'ended'];
-export declare const DefaultSessionStatus = "active";
-export declare const SessionStatus: Schema.Union<readonly [Schema.Literal<"active">, Schema.Literal<"ended">]>;
-export declare const SessionUpdateKind: Schema.Union<readonly [Schema.Literal<"note">, Schema.Literal<"question">, Schema.Literal<"answer">, Schema.Literal<"decision">, Schema.Literal<"blocker">, Schema.Literal<"finding">, Schema.Literal<"handoff">, Schema.Literal<"test_result">, Schema.Literal<"file_reference">, Schema.Literal<"status_change">, Schema.Literal<"assignment_change">, Schema.Literal<"link">]>;
-export declare const Session: Schema.Struct<{
-    readonly id: Schema.String;
-    readonly workspaceId: Schema.String;
-    readonly projectId: Schema.optionalKey<Schema.String>;
-    readonly taskId: Schema.String;
-    readonly actorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
-    readonly actorId: Schema.String;
-    readonly actorName: Schema.optionalKey<Schema.String>;
-    readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
-    readonly agentName: Schema.optionalKey<Schema.String>;
-    readonly agentIdentityId: Schema.optionalKey<Schema.String>;
-    readonly runtimeMetadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
-    readonly modelMetadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
-    readonly status: Schema.Union<readonly [Schema.Literal<"active">, Schema.Literal<"ended">]>;
-    readonly summary: Schema.optionalKey<Schema.String>;
-    readonly startedAt: Schema.String;
-    readonly endedAt: Schema.optionalKey<Schema.String>;
-    readonly createdAt: Schema.String;
-    readonly updatedAt: Schema.String;
-}>;
-export declare const SessionCreate: Schema.Struct<{
-    readonly summary: Schema.optionalKey<Schema.String>;
-    readonly agentIdentityId: Schema.optionalKey<Schema.String>;
-    readonly runtimeMetadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
-    readonly modelMetadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
-}>;
-export declare const SessionEnd: Schema.Struct<{
-    readonly summary: Schema.optionalKey<Schema.String>;
-}>;
-export declare const SessionList: Schema.Struct<{
-    readonly items: Schema.$Array<Schema.Struct<{
-        readonly id: Schema.String;
-        readonly workspaceId: Schema.String;
-        readonly projectId: Schema.optionalKey<Schema.String>;
-        readonly taskId: Schema.String;
-        readonly actorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
-        readonly actorId: Schema.String;
-        readonly actorName: Schema.optionalKey<Schema.String>;
-        readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
-        readonly agentName: Schema.optionalKey<Schema.String>;
-        readonly agentIdentityId: Schema.optionalKey<Schema.String>;
-        readonly runtimeMetadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
-        readonly modelMetadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
-        readonly status: Schema.Union<readonly [Schema.Literal<"active">, Schema.Literal<"ended">]>;
-        readonly summary: Schema.optionalKey<Schema.String>;
-        readonly startedAt: Schema.String;
-        readonly endedAt: Schema.optionalKey<Schema.String>;
-        readonly createdAt: Schema.String;
-        readonly updatedAt: Schema.String;
-    }>>;
-}>;
-export declare const SessionUpdate: Schema.Struct<{
-    readonly id: Schema.String;
-    readonly sessionId: Schema.String;
-    readonly taskId: Schema.String;
-    readonly kind: Schema.Union<readonly [Schema.Literal<"note">, Schema.Literal<"question">, Schema.Literal<"answer">, Schema.Literal<"decision">, Schema.Literal<"blocker">, Schema.Literal<"finding">, Schema.Literal<"handoff">, Schema.Literal<"test_result">, Schema.Literal<"file_reference">, Schema.Literal<"status_change">, Schema.Literal<"assignment_change">, Schema.Literal<"link">]>;
-    readonly content: Schema.String;
-    readonly metadata: Schema.$Record<Schema.String, Schema.Unknown>;
-    readonly createdAt: Schema.String;
-}>;
-export declare const SessionUpdateList: Schema.Struct<{
-    readonly items: Schema.$Array<Schema.Struct<{
-        readonly id: Schema.String;
-        readonly sessionId: Schema.String;
-        readonly taskId: Schema.String;
-        readonly kind: Schema.Union<readonly [Schema.Literal<"note">, Schema.Literal<"question">, Schema.Literal<"answer">, Schema.Literal<"decision">, Schema.Literal<"blocker">, Schema.Literal<"finding">, Schema.Literal<"handoff">, Schema.Literal<"test_result">, Schema.Literal<"file_reference">, Schema.Literal<"status_change">, Schema.Literal<"assignment_change">, Schema.Literal<"link">]>;
-        readonly content: Schema.String;
-        readonly metadata: Schema.$Record<Schema.String, Schema.Unknown>;
-        readonly createdAt: Schema.String;
-    }>>;
-}>;
-export declare const SessionUpdateCreate: Schema.Struct<{
-    readonly kind: Schema.Union<readonly [Schema.Literal<"note">, Schema.Literal<"question">, Schema.Literal<"answer">, Schema.Literal<"decision">, Schema.Literal<"blocker">, Schema.Literal<"finding">, Schema.Literal<"handoff">, Schema.Literal<"test_result">, Schema.Literal<"file_reference">, Schema.Literal<"status_change">, Schema.Literal<"assignment_change">, Schema.Literal<"link">]>;
-    readonly content: Schema.String;
-    readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
-}>;
-export type SessionStatus = (typeof SessionStatus)['Type'];
-export type SessionUpdateKind = (typeof SessionUpdateKind)['Type'];
-export type Session = (typeof Session)['Type'];
-export type SessionCreate = (typeof SessionCreate)['Type'];
-export type SessionEnd = (typeof SessionEnd)['Type'];
-export type SessionList = (typeof SessionList)['Type'];
-export type SessionUpdate = (typeof SessionUpdate)['Type'];
-export type SessionUpdateList = (typeof SessionUpdateList)['Type'];
-export type SessionUpdateCreate = (typeof SessionUpdateCreate)['Type'];

package/types/packages/core/src/step-brief.d.ts

@@ -1,50 +0,0 @@
-import type { JsonObject } from './runtime-type';
-/** Validates an Output against its JSON Schema; the message is what the agent sees for its one repair. */
-export declare function validateAgentOutput(schema: JsonObject, output: JsonObject): {
-    readonly ok: true;
-} | {
-    readonly ok: false;
-    readonly message: string;
-};
-/** The first message an agent receives. */
-export declare function renderStepBriefPrompt(input: {
-    readonly instruction: string;
-    readonly contextPackMarkdown?: string;
-    readonly outputSchema: JsonObject;
-}): string;
-type ContextArtifact = {
-    readonly title: string;
-    readonly kind: string;
-    readonly text: string;
-};
-/**
- * A program agent Step's ContextPack: its Task's context, this Run's artifacts, related artifacts from earlier Runs,
- * and what earlier attempts of the Step recorded; then the Run's Intent and steering. Undefined when there is nothing to say.
- */
-export declare function programStepContext(input: {
-    readonly taskContext?: string;
-    /** The Project's Kits, for a Run with no Task whose ContextPack would carry them. */
-    readonly kits?: string;
-    readonly runArtifacts: readonly ContextArtifact[];
-    readonly earlierArtifacts: readonly ContextArtifact[];
-    readonly handoff: readonly {
-        readonly attempt: number;
-        readonly kind: string;
-        readonly content: string;
-    }[];
-    /** The Run's current Intent, as Oversight renders it. */
-    readonly intent?: string;
-    readonly steering?: readonly string[];
-}): string | undefined;
-/** The program's prompt, and how the agent leaves a trail a retry on another Runner can follow. */
-export declare const programStepInstruction: (prompt: string) => string;
-type StepCredentialLease = {
-    readonly stepAttemptId: string;
-    readonly leaseId: string;
-    readonly fencingToken: string;
-};
-/** The agent's credential for StepAttempt-scoped Kitman MCP tools; it is valid only for the lease it was minted for. */
-export declare function mintStepCredential(secret: string, lease: StepCredentialLease): string;
-export declare function stepCredentialAttemptId(credential: string): string | undefined;
-export declare function stepCredentialMatches(secret: string, credential: string, lease: StepCredentialLease): boolean;
-export {};