@kitman-sh/sdk 0.7.4 → 0.8.0

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

@@ -0,0 +1,127 @@
+import * as Schema from 'effect/Schema';
+/** A Loop or Package in git or npm that the Marketplace lists; Kitman keeps no copy of it (ADR-0071). */
+export declare const MarketplaceReference: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly kind: Schema.Literals<readonly ["loop", "package"]>;
+    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.NonEmptyArray<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.Literals<readonly ["loop", "package"]>;
+    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.NonEmptyArray<Schema.Struct<{
+        readonly id: Schema.String;
+        readonly export: Schema.String;
+    }>>;
+}>>;
+/** Kitman's own references. */
+export declare const shippedMarketplaceReferences: readonly MarketplaceReference[];
+export declare const MarketplaceItemKind: Schema.Literals<readonly ["kit", "loop", "package"]>;
+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">;
+}>]>;
+export type MarketplaceItemState = typeof MarketplaceItemState.Type;
+export declare const MarketplaceItem: Schema.Struct<{
+    readonly id: Schema.String;
+    readonly kind: Schema.Literals<readonly ["kit", "loop", "package"]>;
+    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/loops`. */
+    readonly source: Schema.String;
+    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">;
+    }>]>;
+}>;
+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.Literals<readonly ["kit", "loop", "package"]>;
+        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/loops`. */
+        readonly source: Schema.String;
+        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">;
+        }>]>;
+    }>>;
+}>;
+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.Literals<readonly ["kit", "loop", "package"]>;
+    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 Loops cannot be listed. */
+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/memory.d.ts

@@ -2,24 +2,24 @@ 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 ['kit', 'project', 'task'];
-export declare const MemoryScope: Schema.Union<readonly [Schema.Literal<"kit">, Schema.Literal<"project">, Schema.Literal<"task">]>;
+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">]>;
+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.Union<readonly [Schema.Literal<"kit">, Schema.Literal<"project">, Schema.Literal<"task">]>;
+    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">]>>;
+    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;
@@ -28,16 +28,20 @@ export declare const Memory: Schema.Struct<{
     readonly updatedAt: Schema.String;
 }>;
 export declare const MemoryPropose: Schema.Struct<{
-    readonly scopeType: Schema.Union<readonly [Schema.Literal<"kit">, Schema.Literal<"project">, Schema.Literal<"task">]>;
+    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">]>>;
+    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.Union<readonly [Schema.Literal<"kit">, Schema.Literal<"project">, Schema.Literal<"task">]>>;
+    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]>>;
 }>;
@@ -45,12 +49,12 @@ export declare const MemoryList: Schema.Struct<{
     readonly items: Schema.$Array<Schema.Struct<{
         readonly id: Schema.String;
         readonly workspaceId: Schema.String;
-        readonly scopeType: Schema.Union<readonly [Schema.Literal<"kit">, Schema.Literal<"project">, Schema.Literal<"task">]>;
+        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">]>>;
+        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;
@@ -63,12 +67,12 @@ export declare const MemoryTransitionResult: Schema.Struct<{
     readonly memory: Schema.Struct<{
         readonly id: Schema.String;
         readonly workspaceId: Schema.String;
-        readonly scopeType: Schema.Union<readonly [Schema.Literal<"kit">, Schema.Literal<"project">, Schema.Literal<"task">]>;
+        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">]>>;
+        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;
@@ -78,6 +82,7 @@ export declare const MemoryTransitionResult: Schema.Struct<{
     }>;
 }>;
 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'];