@lssm/lib.contracts 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217073102

package/dist/knowledge/contracts.d.ts

@@ -1,46 +1,46 @@
 import { ContractSpec } from "../spec.js";
 import { SpecRegistry } from "../registry.js";
-import * as _lssm_lib_schema0 from "@lssm/lib.schema";
+import * as _lssm_lib_schema272 from "@lssm/lib.schema";
 import { SchemaModel } from "@lssm/lib.schema";
 
 //#region src/knowledge/contracts.d.ts
 declare const CreateKnowledgeSource: ContractSpec<SchemaModel<{
   tenantId: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
   spaceKey: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
   spaceVersion: {
-    type: _lssm_lib_schema0.FieldType<number, number>;
+    type: _lssm_lib_schema272.FieldType<number, number>;
     isOptional: false;
   };
   label: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
   sourceType: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
   config: {
-    type: _lssm_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    type: _lssm_lib_schema272.FieldType<Record<string, unknown>, Record<string, unknown>>;
     isOptional: false;
   };
   syncSchedule: {
     type: SchemaModel<{
       enabled: {
-        type: _lssm_lib_schema0.FieldType<boolean, boolean>;
+        type: _lssm_lib_schema272.FieldType<boolean, boolean>;
         isOptional: false;
       };
       cron: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema272.FieldType<string, string>;
         isOptional: true;
       };
       intervalMs: {
-        type: _lssm_lib_schema0.FieldType<number, number>;
+        type: _lssm_lib_schema272.FieldType<number, number>;
         isOptional: true;
       };
     }>;
@@ -48,92 +48,92 @@ declare const CreateKnowledgeSource: ContractSpec<SchemaModel<{
   };
 }>, SchemaModel<{
   id: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
   tenantId: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
   spaceKey: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
   spaceVersion: {
-    type: _lssm_lib_schema0.FieldType<number, number>;
+    type: _lssm_lib_schema272.FieldType<number, number>;
     isOptional: false;
   };
   label: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
   sourceType: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
   syncSchedule: {
     type: SchemaModel<{
       enabled: {
-        type: _lssm_lib_schema0.FieldType<boolean, boolean>;
+        type: _lssm_lib_schema272.FieldType<boolean, boolean>;
         isOptional: false;
       };
       cron: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema272.FieldType<string, string>;
         isOptional: true;
       };
       intervalMs: {
-        type: _lssm_lib_schema0.FieldType<number, number>;
+        type: _lssm_lib_schema272.FieldType<number, number>;
         isOptional: true;
       };
     }>;
     isOptional: true;
   };
   lastSyncStatus: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: true;
   };
   lastSyncAt: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema272.FieldType<Date, string>;
     isOptional: true;
   };
   itemsProcessed: {
-    type: _lssm_lib_schema0.FieldType<number, number>;
+    type: _lssm_lib_schema272.FieldType<number, number>;
     isOptional: true;
   };
   createdAt: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema272.FieldType<Date, string>;
     isOptional: true;
   };
   updatedAt: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema272.FieldType<Date, string>;
     isOptional: true;
   };
 }>, undefined>;
 declare const UpdateKnowledgeSource: ContractSpec<SchemaModel<{
   sourceId: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
   label: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: true;
   };
   config: {
-    type: _lssm_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    type: _lssm_lib_schema272.FieldType<Record<string, unknown>, Record<string, unknown>>;
     isOptional: true;
   };
   syncSchedule: {
     type: SchemaModel<{
       enabled: {
-        type: _lssm_lib_schema0.FieldType<boolean, boolean>;
+        type: _lssm_lib_schema272.FieldType<boolean, boolean>;
         isOptional: false;
       };
       cron: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema272.FieldType<string, string>;
         isOptional: true;
       };
       intervalMs: {
-        type: _lssm_lib_schema0.FieldType<number, number>;
+        type: _lssm_lib_schema272.FieldType<number, number>;
         isOptional: true;
       };
     }>;
@@ -141,149 +141,149 @@ declare const UpdateKnowledgeSource: ContractSpec<SchemaModel<{
   };
 }>, SchemaModel<{
   id: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
   tenantId: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
   spaceKey: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
   spaceVersion: {
-    type: _lssm_lib_schema0.FieldType<number, number>;
+    type: _lssm_lib_schema272.FieldType<number, number>;
     isOptional: false;
   };
   label: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
   sourceType: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
   syncSchedule: {
     type: SchemaModel<{
       enabled: {
-        type: _lssm_lib_schema0.FieldType<boolean, boolean>;
+        type: _lssm_lib_schema272.FieldType<boolean, boolean>;
         isOptional: false;
       };
       cron: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema272.FieldType<string, string>;
         isOptional: true;
       };
       intervalMs: {
-        type: _lssm_lib_schema0.FieldType<number, number>;
+        type: _lssm_lib_schema272.FieldType<number, number>;
         isOptional: true;
       };
     }>;
     isOptional: true;
   };
   lastSyncStatus: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: true;
   };
   lastSyncAt: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema272.FieldType<Date, string>;
     isOptional: true;
   };
   itemsProcessed: {
-    type: _lssm_lib_schema0.FieldType<number, number>;
+    type: _lssm_lib_schema272.FieldType<number, number>;
     isOptional: true;
   };
   createdAt: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema272.FieldType<Date, string>;
     isOptional: true;
   };
   updatedAt: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema272.FieldType<Date, string>;
     isOptional: true;
   };
 }>, undefined>;
 declare const DeleteKnowledgeSource: ContractSpec<SchemaModel<{
   sourceId: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   success: {
-    type: _lssm_lib_schema0.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema272.FieldType<boolean, boolean>;
     isOptional: false;
   };
 }>, undefined>;
 declare const ListKnowledgeSources: ContractSpec<SchemaModel<{
   tenantId: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
   spaceKey: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: true;
   };
 }>, SchemaModel<{
   sources: {
     type: SchemaModel<{
       id: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema272.FieldType<string, string>;
         isOptional: false;
       };
       tenantId: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema272.FieldType<string, string>;
         isOptional: false;
       };
       spaceKey: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema272.FieldType<string, string>;
         isOptional: false;
       };
       spaceVersion: {
-        type: _lssm_lib_schema0.FieldType<number, number>;
+        type: _lssm_lib_schema272.FieldType<number, number>;
         isOptional: false;
       };
       label: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema272.FieldType<string, string>;
         isOptional: false;
       };
       sourceType: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema272.FieldType<string, string>;
         isOptional: false;
       };
       syncSchedule: {
         type: SchemaModel<{
           enabled: {
-            type: _lssm_lib_schema0.FieldType<boolean, boolean>;
+            type: _lssm_lib_schema272.FieldType<boolean, boolean>;
             isOptional: false;
           };
           cron: {
-            type: _lssm_lib_schema0.FieldType<string, string>;
+            type: _lssm_lib_schema272.FieldType<string, string>;
             isOptional: true;
           };
           intervalMs: {
-            type: _lssm_lib_schema0.FieldType<number, number>;
+            type: _lssm_lib_schema272.FieldType<number, number>;
             isOptional: true;
           };
         }>;
         isOptional: true;
       };
       lastSyncStatus: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema272.FieldType<string, string>;
         isOptional: true;
       };
       lastSyncAt: {
-        type: _lssm_lib_schema0.FieldType<Date, string>;
+        type: _lssm_lib_schema272.FieldType<Date, string>;
         isOptional: true;
       };
       itemsProcessed: {
-        type: _lssm_lib_schema0.FieldType<number, number>;
+        type: _lssm_lib_schema272.FieldType<number, number>;
         isOptional: true;
       };
       createdAt: {
-        type: _lssm_lib_schema0.FieldType<Date, string>;
+        type: _lssm_lib_schema272.FieldType<Date, string>;
         isOptional: true;
       };
       updatedAt: {
-        type: _lssm_lib_schema0.FieldType<Date, string>;
+        type: _lssm_lib_schema272.FieldType<Date, string>;
         isOptional: true;
       };
     }>;
@@ -293,20 +293,20 @@ declare const ListKnowledgeSources: ContractSpec<SchemaModel<{
 }>, undefined>;
 declare const TriggerKnowledgeSourceSync: ContractSpec<SchemaModel<{
   sourceId: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: false;
   };
 }>, SchemaModel<{
   success: {
-    type: _lssm_lib_schema0.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema272.FieldType<boolean, boolean>;
     isOptional: false;
   };
   itemsProcessed: {
-    type: _lssm_lib_schema0.FieldType<number, number>;
+    type: _lssm_lib_schema272.FieldType<number, number>;
     isOptional: true;
   };
   error: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema272.FieldType<string, string>;
     isOptional: true;
   };
 }>, undefined>;

package/dist/knowledge/contracts.js

@@ -1 +1,317 @@
-import{l as e}from"../schema/dist/ScalarTypeEnum.js";import{t}from"../schema/dist/SchemaModel.js";import"../schema/dist/index.js";import{defineCommand as n,defineQuery as r}from"../spec.js";const i=new t({name:`KnowledgeSyncSchedule`,fields:{enabled:{type:e.Boolean(),isOptional:!1},cron:{type:e.String_unsecure(),isOptional:!0},intervalMs:{type:e.Int_unsecure(),isOptional:!0}}}),a=new t({name:`KnowledgeSourceRecord`,fields:{id:{type:e.ID(),isOptional:!1},tenantId:{type:e.ID(),isOptional:!1},spaceKey:{type:e.NonEmptyString(),isOptional:!1},spaceVersion:{type:e.Int_unsecure(),isOptional:!1},label:{type:e.String_unsecure(),isOptional:!1},sourceType:{type:e.String_unsecure(),isOptional:!1},syncSchedule:{type:i,isOptional:!0},lastSyncStatus:{type:e.String_unsecure(),isOptional:!0},lastSyncAt:{type:e.DateTime(),isOptional:!0},itemsProcessed:{type:e.Int_unsecure(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!0},updatedAt:{type:e.DateTime(),isOptional:!0}}}),o=new t({name:`CreateKnowledgeSourceInput`,fields:{tenantId:{type:e.ID(),isOptional:!1},spaceKey:{type:e.NonEmptyString(),isOptional:!1},spaceVersion:{type:e.Int_unsecure(),isOptional:!1},label:{type:e.String_unsecure(),isOptional:!1},sourceType:{type:e.NonEmptyString(),isOptional:!1},config:{type:e.JSONObject(),isOptional:!1},syncSchedule:{type:i,isOptional:!0}}}),s=new t({name:`UpdateKnowledgeSourceInput`,fields:{sourceId:{type:e.ID(),isOptional:!1},label:{type:e.String_unsecure(),isOptional:!0},config:{type:e.JSONObject(),isOptional:!0},syncSchedule:{type:i,isOptional:!0}}}),c=new t({name:`DeleteKnowledgeSourceInput`,fields:{sourceId:{type:e.ID(),isOptional:!1}}}),l=new t({name:`DeleteKnowledgeSourceOutput`,fields:{success:{type:e.Boolean(),isOptional:!1}}}),u=new t({name:`ListKnowledgeSourcesInput`,fields:{tenantId:{type:e.ID(),isOptional:!1},spaceKey:{type:e.NonEmptyString(),isOptional:!0}}}),d=new t({name:`ListKnowledgeSourcesOutput`,fields:{sources:{type:a,isOptional:!1,isArray:!0}}}),f=new t({name:`TriggerKnowledgeSyncInput`,fields:{sourceId:{type:e.ID(),isOptional:!1}}}),p=new t({name:`TriggerKnowledgeSyncOutput`,fields:{success:{type:e.Boolean(),isOptional:!1},itemsProcessed:{type:e.Int_unsecure(),isOptional:!0},error:{type:e.String_unsecure(),isOptional:!0}}}),m=n({meta:{name:`knowledge.source.create`,version:1,description:`Create a knowledge source binding for a tenant.`,goal:`Onboard a new knowledge ingestion source such as Notion or uploads.`,context:`Used by Ops and App Studio to configure knowledge ingestion per tenant and space.`,owners:[`platform.knowledge`],tags:[`knowledge`,`sources`],stability:`experimental`},io:{input:o,output:a},policy:{auth:`admin`,policies:[{name:`platform.knowledge.manage`,version:1}]}}),h=n({meta:{name:`knowledge.source.update`,version:1,description:`Update metadata or configuration for a knowledge source.`,goal:`Allow rotation of credentials, sync schedules, and labels.`,context:`Supports editing how a tenant ingests knowledge (e.g., toggling sync cadence).`,owners:[`platform.knowledge`],tags:[`knowledge`,`sources`],stability:`experimental`},io:{input:s,output:a},policy:{auth:`admin`,policies:[{name:`platform.knowledge.manage`,version:1}]}}),g=n({meta:{name:`knowledge.source.delete`,version:1,description:`Delete a knowledge source binding for a tenant.`,goal:`Remove obsolete or compromised knowledge ingestion paths.`,context:`Ensures ephemeral or external sources can be removed cleanly without leaving residual bindings.`,owners:[`platform.knowledge`],tags:[`knowledge`,`sources`],stability:`experimental`},io:{input:c,output:l},policy:{auth:`admin`,policies:[{name:`platform.knowledge.manage`,version:1}]}}),_=r({meta:{name:`knowledge.source.list`,version:1,description:`List knowledge sources configured for a tenant.`,goal:`Provide visibility into knowledge ingest configuration and schedules.`,context:`Used by App Studio and Ops flows to surface knowledge sources and their health.`,owners:[`platform.knowledge`],tags:[`knowledge`,`sources`],stability:`experimental`},io:{input:u,output:d},policy:{auth:`admin`,policies:[{name:`platform.knowledge.read`,version:1}]}}),v=n({meta:{name:`knowledge.source.triggerSync`,version:1,description:`Trigger an immediate sync for a knowledge source.`,goal:`Support manual or automated sync retries for knowledge ingestion.`,context:`Invoked by Ops tooling or monitors when knowledge content must be refreshed or reprocessed.`,owners:[`platform.knowledge`],tags:[`knowledge`,`sources`],stability:`experimental`},io:{input:f,output:p},policy:{auth:`admin`,policies:[{name:`platform.knowledge.manage`,version:1}]}}),y={CreateKnowledgeSource:m,UpdateKnowledgeSource:h,DeleteKnowledgeSource:g,ListKnowledgeSources:_,TriggerKnowledgeSourceSync:v};function b(e){return e.register(m).register(h).register(g).register(_).register(v)}export{m as CreateKnowledgeSource,g as DeleteKnowledgeSource,_ as ListKnowledgeSources,v as TriggerKnowledgeSourceSync,h as UpdateKnowledgeSource,y as knowledgeContracts,b as registerKnowledgeContracts};
+import { ScalarTypeEnum } from "../schema/dist/ScalarTypeEnum.js";
+import { SchemaModel } from "../schema/dist/SchemaModel.js";
+import "../schema/dist/index.js";
+import { defineCommand, defineQuery } from "../spec.js";
+
+//#region src/knowledge/contracts.ts
+const KnowledgeSyncSchedule = new SchemaModel({
+	name: "KnowledgeSyncSchedule",
+	fields: {
+		enabled: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: false
+		},
+		cron: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		intervalMs: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const KnowledgeSourceRecord = new SchemaModel({
+	name: "KnowledgeSourceRecord",
+	fields: {
+		id: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		spaceKey: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		spaceVersion: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		label: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		sourceType: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		syncSchedule: {
+			type: KnowledgeSyncSchedule,
+			isOptional: true
+		},
+		lastSyncStatus: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		lastSyncAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		itemsProcessed: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		},
+		updatedAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: true
+		}
+	}
+});
+const CreateKnowledgeSourceInput = new SchemaModel({
+	name: "CreateKnowledgeSourceInput",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		spaceKey: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		spaceVersion: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: false
+		},
+		label: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		sourceType: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: false
+		},
+		config: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: false
+		},
+		syncSchedule: {
+			type: KnowledgeSyncSchedule,
+			isOptional: true
+		}
+	}
+});
+const UpdateKnowledgeSourceInput = new SchemaModel({
+	name: "UpdateKnowledgeSourceInput",
+	fields: {
+		sourceId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		label: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		config: {
+			type: ScalarTypeEnum.JSONObject(),
+			isOptional: true
+		},
+		syncSchedule: {
+			type: KnowledgeSyncSchedule,
+			isOptional: true
+		}
+	}
+});
+const DeleteKnowledgeSourceInput = new SchemaModel({
+	name: "DeleteKnowledgeSourceInput",
+	fields: { sourceId: {
+		type: ScalarTypeEnum.ID(),
+		isOptional: false
+	} }
+});
+const DeleteKnowledgeSourceOutput = new SchemaModel({
+	name: "DeleteKnowledgeSourceOutput",
+	fields: { success: {
+		type: ScalarTypeEnum.Boolean(),
+		isOptional: false
+	} }
+});
+const ListKnowledgeSourcesInput = new SchemaModel({
+	name: "ListKnowledgeSourcesInput",
+	fields: {
+		tenantId: {
+			type: ScalarTypeEnum.ID(),
+			isOptional: false
+		},
+		spaceKey: {
+			type: ScalarTypeEnum.NonEmptyString(),
+			isOptional: true
+		}
+	}
+});
+const ListKnowledgeSourcesOutput = new SchemaModel({
+	name: "ListKnowledgeSourcesOutput",
+	fields: { sources: {
+		type: KnowledgeSourceRecord,
+		isOptional: false,
+		isArray: true
+	} }
+});
+const TriggerKnowledgeSyncInput = new SchemaModel({
+	name: "TriggerKnowledgeSyncInput",
+	fields: { sourceId: {
+		type: ScalarTypeEnum.ID(),
+		isOptional: false
+	} }
+});
+const TriggerKnowledgeSyncOutput = new SchemaModel({
+	name: "TriggerKnowledgeSyncOutput",
+	fields: {
+		success: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: false
+		},
+		itemsProcessed: {
+			type: ScalarTypeEnum.Int_unsecure(),
+			isOptional: true
+		},
+		error: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+const CreateKnowledgeSource = defineCommand({
+	meta: {
+		name: "knowledge.source.create",
+		version: 1,
+		description: "Create a knowledge source binding for a tenant.",
+		goal: "Onboard a new knowledge ingestion source such as Notion or uploads.",
+		context: "Used by Ops and App Studio to configure knowledge ingestion per tenant and space.",
+		owners: ["platform.knowledge"],
+		tags: ["knowledge", "sources"],
+		stability: "experimental"
+	},
+	io: {
+		input: CreateKnowledgeSourceInput,
+		output: KnowledgeSourceRecord
+	},
+	policy: {
+		auth: "admin",
+		policies: [{
+			name: "platform.knowledge.manage",
+			version: 1
+		}]
+	}
+});
+const UpdateKnowledgeSource = defineCommand({
+	meta: {
+		name: "knowledge.source.update",
+		version: 1,
+		description: "Update metadata or configuration for a knowledge source.",
+		goal: "Allow rotation of credentials, sync schedules, and labels.",
+		context: "Supports editing how a tenant ingests knowledge (e.g., toggling sync cadence).",
+		owners: ["platform.knowledge"],
+		tags: ["knowledge", "sources"],
+		stability: "experimental"
+	},
+	io: {
+		input: UpdateKnowledgeSourceInput,
+		output: KnowledgeSourceRecord
+	},
+	policy: {
+		auth: "admin",
+		policies: [{
+			name: "platform.knowledge.manage",
+			version: 1
+		}]
+	}
+});
+const DeleteKnowledgeSource = defineCommand({
+	meta: {
+		name: "knowledge.source.delete",
+		version: 1,
+		description: "Delete a knowledge source binding for a tenant.",
+		goal: "Remove obsolete or compromised knowledge ingestion paths.",
+		context: "Ensures ephemeral or external sources can be removed cleanly without leaving residual bindings.",
+		owners: ["platform.knowledge"],
+		tags: ["knowledge", "sources"],
+		stability: "experimental"
+	},
+	io: {
+		input: DeleteKnowledgeSourceInput,
+		output: DeleteKnowledgeSourceOutput
+	},
+	policy: {
+		auth: "admin",
+		policies: [{
+			name: "platform.knowledge.manage",
+			version: 1
+		}]
+	}
+});
+const ListKnowledgeSources = defineQuery({
+	meta: {
+		name: "knowledge.source.list",
+		version: 1,
+		description: "List knowledge sources configured for a tenant.",
+		goal: "Provide visibility into knowledge ingest configuration and schedules.",
+		context: "Used by App Studio and Ops flows to surface knowledge sources and their health.",
+		owners: ["platform.knowledge"],
+		tags: ["knowledge", "sources"],
+		stability: "experimental"
+	},
+	io: {
+		input: ListKnowledgeSourcesInput,
+		output: ListKnowledgeSourcesOutput
+	},
+	policy: {
+		auth: "admin",
+		policies: [{
+			name: "platform.knowledge.read",
+			version: 1
+		}]
+	}
+});
+const TriggerKnowledgeSourceSync = defineCommand({
+	meta: {
+		name: "knowledge.source.triggerSync",
+		version: 1,
+		description: "Trigger an immediate sync for a knowledge source.",
+		goal: "Support manual or automated sync retries for knowledge ingestion.",
+		context: "Invoked by Ops tooling or monitors when knowledge content must be refreshed or reprocessed.",
+		owners: ["platform.knowledge"],
+		tags: ["knowledge", "sources"],
+		stability: "experimental"
+	},
+	io: {
+		input: TriggerKnowledgeSyncInput,
+		output: TriggerKnowledgeSyncOutput
+	},
+	policy: {
+		auth: "admin",
+		policies: [{
+			name: "platform.knowledge.manage",
+			version: 1
+		}]
+	}
+});
+const knowledgeContracts = {
+	CreateKnowledgeSource,
+	UpdateKnowledgeSource,
+	DeleteKnowledgeSource,
+	ListKnowledgeSources,
+	TriggerKnowledgeSourceSync
+};
+function registerKnowledgeContracts(registry) {
+	return registry.register(CreateKnowledgeSource).register(UpdateKnowledgeSource).register(DeleteKnowledgeSource).register(ListKnowledgeSources).register(TriggerKnowledgeSourceSync);
+}
+
+//#endregion
+export { CreateKnowledgeSource, DeleteKnowledgeSource, ListKnowledgeSources, TriggerKnowledgeSourceSync, UpdateKnowledgeSource, knowledgeContracts, registerKnowledgeContracts };