@kitman-sh/sdk 0.10.82 → 0.10.83

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

@@ -0,0 +1,168 @@
+import * as Schema from 'effect/Schema';
+/**
+ * A Kit in npm, which Add installs, or in git, which Add lists in the deployed Kit by merge request; Kitman keeps no
+ * copy of it (ADR-0071).
+ */
+export declare const MarketplaceReference: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly kind: Schema.Literal<"kit">;
+    readonly name: Schema.String;
+    readonly publisher: Schema.String;
+    readonly description: Schema.String;
+    readonly category: Schema.String;
+    /** The name a configuration depends on it by. */
+    readonly package: Schema.String;
+    readonly source: Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.Literal<"npm">;
+        readonly version: Schema.optionalKey<Schema.String>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"git">;
+        readonly url: Schema.String;
+        readonly ref: Schema.optionalKey<Schema.String>;
+    }>]>;
+    /** The Loops it provides, each by its id and the name the package exports it under. */
+    readonly loops: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly export: Schema.String;
+    }>>;
+}>;
+export type MarketplaceReference = typeof MarketplaceReference.Type;
+export declare const MarketplaceReferences: Schema.$Array<Schema.Struct<{
+    readonly id: Schema.String;
+    readonly kind: Schema.Literal<"kit">;
+    readonly name: Schema.String;
+    readonly publisher: Schema.String;
+    readonly description: Schema.String;
+    readonly category: Schema.String;
+    /** The name a configuration depends on it by. */
+    readonly package: Schema.String;
+    readonly source: Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.Literal<"npm">;
+        readonly version: Schema.optionalKey<Schema.String>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"git">;
+        readonly url: Schema.String;
+        readonly ref: Schema.optionalKey<Schema.String>;
+    }>]>;
+    /** The Loops it provides, each by its id and the name the package exports it under. */
+    readonly loops: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly export: Schema.String;
+    }>>;
+}>>;
+/** Kitman's official Kits. */
+export declare const officialMarketplaceReferences: readonly MarketplaceReference[];
+export declare const MarketplaceItemKind: Schema.Literal<"kit">;
+export type MarketplaceItemKind = typeof MarketplaceItemKind.Type;
+export declare const MarketplaceItemState: Schema.Union<readonly [Schema.Struct<{
+    readonly state: Schema.Literal<"add">;
+}>, Schema.Struct<{
+    readonly state: Schema.Literal<"merge_request_open">;
+    readonly forge: Schema.String;
+    readonly url: Schema.optionalKey<Schema.String>;
+    readonly number: Schema.optionalKey<Schema.String>;
+}>, Schema.Struct<{
+    readonly state: Schema.Literal<"added">;
+}>, Schema.Struct<{
+    readonly state: Schema.Literal<"installed">;
+    /** Absent until an install carried over from the old Kit model is first resolved. */
+    readonly version: Schema.optionalKey<Schema.String>;
+    readonly pinnedVersion: Schema.optionalKey<Schema.String>;
+    readonly problem: Schema.optionalKey<Schema.String>;
+    /** The person its Loops act for; with nobody, they start only once someone Adds it again. */
+    readonly actsFor: Schema.optionalKey<Schema.String>;
+}>]>;
+export type MarketplaceItemState = typeof MarketplaceItemState.Type;
+export declare const MarketplaceItem: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly kind: Schema.Literal<"kit">;
+    readonly name: Schema.String;
+    readonly publisher: Schema.String;
+    readonly description: Schema.String;
+    readonly category: Schema.String;
+    /** Where it comes from, such as `npm @kitman-sh/software-engineering`. */
+    readonly source: Schema.String;
+    /** How a referenced Kit is added: installed from npm by its name, or by merge request from git; absent for the old model. */
+    readonly reference: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.Literal<"npm">;
+        readonly name: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"git">;
+    }>]>>;
+    readonly status: Schema.Union<readonly [Schema.Struct<{
+        readonly state: Schema.Literal<"add">;
+    }>, Schema.Struct<{
+        readonly state: Schema.Literal<"merge_request_open">;
+        readonly forge: Schema.String;
+        readonly url: Schema.optionalKey<Schema.String>;
+        readonly number: Schema.optionalKey<Schema.String>;
+    }>, Schema.Struct<{
+        readonly state: Schema.Literal<"added">;
+    }>, Schema.Struct<{
+        readonly state: Schema.Literal<"installed">;
+        /** Absent until an install carried over from the old Kit model is first resolved. */
+        readonly version: Schema.optionalKey<Schema.String>;
+        readonly pinnedVersion: Schema.optionalKey<Schema.String>;
+        readonly problem: Schema.optionalKey<Schema.String>;
+        /** The person its Loops act for; with nobody, they start only once someone Adds it again. */
+        readonly actsFor: Schema.optionalKey<Schema.String>;
+    }>]>;
+}>;
+export type MarketplaceItem = typeof MarketplaceItem.Type;
+export declare const MarketplaceList: Schema.Struct<{
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly kind: Schema.Literal<"kit">;
+        readonly name: Schema.String;
+        readonly publisher: Schema.String;
+        readonly description: Schema.String;
+        readonly category: Schema.String;
+        /** Where it comes from, such as `npm @kitman-sh/software-engineering`. */
+        readonly source: Schema.String;
+        /** How a referenced Kit is added: installed from npm by its name, or by merge request from git; absent for the old model. */
+        readonly reference: Schema.optionalKey<Schema.Union<readonly [Schema.Struct<{
+            readonly type: Schema.Literal<"npm">;
+            readonly name: Schema.String;
+        }>, Schema.Struct<{
+            readonly type: Schema.Literal<"git">;
+        }>]>>;
+        readonly status: Schema.Union<readonly [Schema.Struct<{
+            readonly state: Schema.Literal<"add">;
+        }>, Schema.Struct<{
+            readonly state: Schema.Literal<"merge_request_open">;
+            readonly forge: Schema.String;
+            readonly url: Schema.optionalKey<Schema.String>;
+            readonly number: Schema.optionalKey<Schema.String>;
+        }>, Schema.Struct<{
+            readonly state: Schema.Literal<"added">;
+        }>, Schema.Struct<{
+            readonly state: Schema.Literal<"installed">;
+            /** Absent until an install carried over from the old Kit model is first resolved. */
+            readonly version: Schema.optionalKey<Schema.String>;
+            readonly pinnedVersion: Schema.optionalKey<Schema.String>;
+            readonly problem: Schema.optionalKey<Schema.String>;
+            /** The person its Loops act for; with nobody, they start only once someone Adds it again. */
+            readonly actsFor: Schema.optionalKey<Schema.String>;
+        }>]>;
+    }>>;
+}>;
+export type MarketplaceList = typeof MarketplaceList.Type;
+/** Adds an item to the Workspace, or to one of its Teams. */
+export declare const MarketplaceAdd: Schema.Struct<{
+    readonly kind: Schema.Literal<"kit">;
+    readonly id: Schema.String;
+    readonly teamId: Schema.optionalKey<Schema.String>;
+}>;
+export type MarketplaceAdd = typeof MarketplaceAdd.Type;
+export declare const referenceSource: (reference: MarketplaceReference) => string;
+/** The files a configuration merge request changes to add `reference`; `placed` is false when its Kit cannot be extended. */
+export declare const addConfigReference: (files: {
+    readonly packageJson: string;
+    readonly config: string | undefined;
+}, reference: MarketplaceReference) => {
+    placed: boolean;
+    changes: {
+        path: string;
+        content: string;
+    }[];
+};

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

@@ -0,0 +1,31 @@
+import * as Schema from 'effect/Schema';
+export declare const ActorCredentialType: Schema.Union<readonly [Schema.Literal<"human_session">, Schema.Literal<"human_oauth">, Schema.Literal<"agent_auth">]>;
+export declare const Me: Schema.Union<readonly [Schema.Struct<{
+    readonly workspaceId: Schema.optionalKey<Schema.String>;
+    readonly activeWorkspaceId: Schema.optionalKey<Schema.String>;
+    readonly workspaceRole: Schema.optionalKey<Schema.String>;
+    readonly displayName: Schema.optionalKey<Schema.String>;
+    readonly avatarUrl: Schema.optionalKey<Schema.String>;
+    readonly actorType: Schema.Literal<"human">;
+    readonly actorId: Schema.String;
+    readonly userId: Schema.String;
+    readonly credentialType: Schema.Union<readonly [Schema.Literal<"human_session">, Schema.Literal<"human_oauth">]>;
+}>, Schema.Struct<{
+    readonly workspaceId: Schema.optionalKey<Schema.String>;
+    readonly activeWorkspaceId: Schema.optionalKey<Schema.String>;
+    readonly workspaceRole: Schema.optionalKey<Schema.String>;
+    readonly actorType: Schema.Literal<"delegated_agent">;
+    readonly actorId: Schema.String;
+    readonly delegatedByUserId: Schema.String;
+    readonly toolName: Schema.String;
+    readonly credentialType: Schema.Literal<"agent_auth">;
+}>, Schema.Struct<{
+    readonly workspaceId: Schema.optionalKey<Schema.String>;
+    readonly activeWorkspaceId: Schema.optionalKey<Schema.String>;
+    readonly workspaceRole: Schema.optionalKey<Schema.String>;
+    readonly actorType: Schema.Literal<"agent">;
+    readonly actorId: Schema.String;
+    readonly agentId: Schema.String;
+    readonly credentialType: Schema.Literal<"agent_auth">;
+}>]>;
+export type Me = (typeof Me)['Type'];

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

@@ -0,0 +1,93 @@
+import * as Schema from 'effect/Schema';
+export declare const MemoryStatuses: readonly ['proposed', 'accepted', 'rejected', 'deprecated'];
+export declare const DefaultMemoryStatus = "proposed";
+export declare const MemoryStatus: Schema.Union<readonly [Schema.Literal<"proposed">, Schema.Literal<"accepted">, Schema.Literal<"rejected">, Schema.Literal<"deprecated">]>;
+export declare const MemoryScopes: readonly ['workspace', 'repository', 'loop', 'kit', 'team', 'task'];
+export declare const MemoryScope: Schema.Literals<readonly ["workspace", "repository", "loop", "kit", "team", "task"]>;
+export declare const MemoryConfidences: readonly ['low', 'medium', 'high'];
+export declare const DefaultMemoryConfidence = "medium";
+export declare const MemoryConfidence: Schema.Union<readonly [Schema.Literal<"low">, Schema.Literal<"medium">, Schema.Literal<"high">]>;
+export declare const MemorySourceType: Schema.Union<readonly [Schema.Literal<"user">, Schema.Literal<"agent">, Schema.Literal<"session">, Schema.Literal<"context_pack">, Schema.Literal<"run">]>;
+export declare const MaxMemoryContentLength = 10000;
+export declare const DefaultMemoryListLimit = 50;
+export declare const MaxMemoryListLimit = 100;
+export declare const Memory: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly workspaceId: Schema.String;
+    readonly scopeType: Schema.Literals<readonly ["workspace", "repository", "loop", "kit", "team", "task"]>;
+    readonly scopeId: Schema.String;
+    readonly content: Schema.String;
+    readonly status: Schema.Union<readonly [Schema.Literal<"proposed">, Schema.Literal<"accepted">, Schema.Literal<"rejected">, Schema.Literal<"deprecated">]>;
+    readonly confidence: Schema.Union<readonly [Schema.Literal<"low">, Schema.Literal<"medium">, Schema.Literal<"high">]>;
+    readonly sourceType: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"user">, Schema.Literal<"agent">, Schema.Literal<"session">, Schema.Literal<"context_pack">, Schema.Literal<"run">]>>;
+    readonly sourceId: Schema.optionalKey<Schema.String>;
+    readonly createdByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+    readonly createdByActorId: Schema.String;
+    readonly approvedByUserId: Schema.optionalKey<Schema.String>;
+    readonly createdAt: Schema.String;
+    readonly updatedAt: Schema.String;
+}>;
+export declare const MemoryPropose: Schema.Struct<{
+    readonly scopeType: Schema.Literals<readonly ["workspace", "repository", "loop", "kit", "team", "task"]>;
+    readonly scopeId: Schema.String;
+    readonly content: Schema.String;
+    readonly confidence: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"low">, Schema.Literal<"medium">, Schema.Literal<"high">]>>;
+    readonly sourceType: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"user">, Schema.Literal<"agent">, Schema.Literal<"session">, Schema.Literal<"context_pack">, Schema.Literal<"run">]>>;
+    readonly sourceId: Schema.optionalKey<Schema.String>;
+}>;
+/** New words for proposed Memory, before it is reviewed. */
+export declare const MemoryEdit: Schema.Struct<{
+    readonly content: Schema.String;
+}>;
+export declare const MemoryListQuery: Schema.Struct<{
+    readonly status: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"proposed">, Schema.Literal<"accepted">, Schema.Literal<"rejected">, Schema.Literal<"deprecated">]>>;
+    readonly scopeType: Schema.optionalKey<Schema.Literals<readonly ["workspace", "repository", "loop", "kit", "team", "task"]>>;
+    readonly scopeId: Schema.optionalKey<Schema.String>;
+    readonly limit: Schema.optionalKey<Schema.Union<readonly [Schema.Finite, Schema.FiniteFromString]>>;
+}>;
+export declare const MemoryList: Schema.Struct<{
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly workspaceId: Schema.String;
+        readonly scopeType: Schema.Literals<readonly ["workspace", "repository", "loop", "kit", "team", "task"]>;
+        readonly scopeId: Schema.String;
+        readonly content: Schema.String;
+        readonly status: Schema.Union<readonly [Schema.Literal<"proposed">, Schema.Literal<"accepted">, Schema.Literal<"rejected">, Schema.Literal<"deprecated">]>;
+        readonly confidence: Schema.Union<readonly [Schema.Literal<"low">, Schema.Literal<"medium">, Schema.Literal<"high">]>;
+        readonly sourceType: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"user">, Schema.Literal<"agent">, Schema.Literal<"session">, Schema.Literal<"context_pack">, Schema.Literal<"run">]>>;
+        readonly sourceId: Schema.optionalKey<Schema.String>;
+        readonly createdByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+        readonly createdByActorId: Schema.String;
+        readonly approvedByUserId: Schema.optionalKey<Schema.String>;
+        readonly createdAt: Schema.String;
+        readonly updatedAt: Schema.String;
+    }>>;
+}>;
+export declare const MemoryTransitionResult: Schema.Struct<{
+    readonly memory: Schema.Struct<{
+        readonly id: Schema.String;
+        readonly workspaceId: Schema.String;
+        readonly scopeType: Schema.Literals<readonly ["workspace", "repository", "loop", "kit", "team", "task"]>;
+        readonly scopeId: Schema.String;
+        readonly content: Schema.String;
+        readonly status: Schema.Union<readonly [Schema.Literal<"proposed">, Schema.Literal<"accepted">, Schema.Literal<"rejected">, Schema.Literal<"deprecated">]>;
+        readonly confidence: Schema.Union<readonly [Schema.Literal<"low">, Schema.Literal<"medium">, Schema.Literal<"high">]>;
+        readonly sourceType: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"user">, Schema.Literal<"agent">, Schema.Literal<"session">, Schema.Literal<"context_pack">, Schema.Literal<"run">]>>;
+        readonly sourceId: Schema.optionalKey<Schema.String>;
+        readonly createdByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+        readonly createdByActorId: Schema.String;
+        readonly approvedByUserId: Schema.optionalKey<Schema.String>;
+        readonly createdAt: Schema.String;
+        readonly updatedAt: Schema.String;
+    }>;
+}>;
+export type MemoryStatus = (typeof MemoryStatus)['Type'];
+export type MemoryEdit = (typeof MemoryEdit)['Type'];
+export type MemoryScope = (typeof MemoryScope)['Type'];
+export type MemoryConfidence = (typeof MemoryConfidence)['Type'];
+export type MemorySourceType = (typeof MemorySourceType)['Type'];
+export type Memory = (typeof Memory)['Type'];
+export type MemoryPropose = (typeof MemoryPropose)['Type'];
+export type MemoryListQuery = (typeof MemoryListQuery)['Type'];
+export type MemoryList = (typeof MemoryList)['Type'];
+export type MemoryTransitionResult = (typeof MemoryTransitionResult)['Type'];