@native-knowledge/knowledge-sdk 0.0.0-stage → 0.1.0-rc.2

package/dist/internal/serving-contracts/tenant-project.js

@@ -0,0 +1,39 @@
+/** Provider19 extends Project context without changing the exact v17/v18 registries. */
+import { z } from 'zod';
+import { projectKeySchema, sha256Schema, stableUriSchema, isoDateTimeSchema, materialTenantIdSchema, resourceDirectoryItemSchema, tenantProjectScopeChangeSchema, tenantProjectLifecycleChangeSchema, tenantProjectControlResultSchema, tenantManagementRequestIdSchema } from '../contracts/index.js';
+import { tenantWorkspaceToolSchemas, tenantWorkspaceDataSchemas, tenantWorkspaceScopesForInput, tenantWorkspaceAuthorization } from './tenant-workspace.js';
+import { tenantManagementErrorSchema, tenantManagementProviderBaseSchema } from './tenant-management.js';
+const cursor = z.string().min(1).max(4096), page = { after: cursor.optional(), limit: z.number().int().min(1).max(100).optional() };
+export const tenantProjectToolSchemas = {
+    tenant_project_list: z.object(page).strict(),
+    tenant_project_get: z.object({ projectKey: projectKeySchema, purposeAfter: cursor.optional(), selectionAfter: cursor.optional(), requestId: tenantManagementRequestIdSchema.optional() }).strict(),
+    tenant_project_materials: z.object({ projectKey: projectKeySchema, ...page }).strict(),
+    tenant_project_scope_set: tenantProjectScopeChangeSchema,
+    tenant_project_lifecycle_set: tenantProjectLifecycleChangeSchema,
+};
+const result = tenantProjectControlResultSchema, receipt = z.object({ operationRef: stableUriSchema, action: z.enum(['SET_SCOPE', 'SET_LIFECYCLE']), result, committedAt: isoDateTimeSchema }).strict();
+const purpose = z.object({ state: z.enum(['READY', 'NOT_REGISTERED', 'UNAVAILABLE', 'INTEGRITY_MISMATCH']), revisionRef: stableUriSchema.nullable(), identity: z.object({ name: z.string().max(256), summary: z.string().max(4000), domains: z.array(z.string().max(256)).max(32), domainTotal: z.number().int().min(0).max(256), notes: z.string().max(1000).nullable(), notesTruncated: z.boolean() }).strict().nullable(), scopes: z.array(z.object({ scopeId: z.string().max(128), title: z.string().max(256), description: z.string().max(512), descriptionTruncated: z.boolean(), sourceRequirementCount: z.number().int().min(0).max(256), sourceFamilyCount: z.number().int().min(0).max(256) }).strict()).max(20), scopeTotal: z.number().int().min(0).max(1000).nullable(), nextAfter: cursor.nullable() }).strict();
+const selection = z.object({ state: z.enum(['READY', 'NOT_AUTHORIZED', 'UNAVAILABLE', 'BUDGET_EXCEEDED']), mode: z.enum(['TENANT', 'EXPLICIT']).nullable(), revision: sha256Schema.nullable(), selectors: z.array(z.object({ type: z.enum(['REF', 'SOURCE_PROJECT']), value: z.string().min(1).max(4096) }).strict()).max(20), nextAfter: cursor.nullable() }).strict();
+export const tenantProjectDataSchemas = {
+    tenant_project_list: z.object({ items: z.array(z.object({ projectKey: projectKeySchema, state: z.enum(['ACTIVE', 'ARCHIVED']) }).strict()).max(100), nextAfter: cursor.nullable(), coverage: z.literal('OWN_TENANT_PROJECTS') }).strict(),
+    tenant_project_get: z.object({ projectKey: projectKeySchema, state: z.enum(['ACTIVE', 'ARCHIVED']), lifecycleRevision: sha256Schema, controlReady: z.boolean(), purpose, selection, receipt: receipt.nullable() }).strict(),
+    tenant_project_materials: z.object({ projectKey: projectKeySchema, policy: z.literal('TENANT_PROJECT_SCOPE'), items: z.array(resourceDirectoryItemSchema).max(100), nextAfter: cursor.nullable() }).strict(),
+    tenant_project_scope_set: z.object({ projectKey: projectKeySchema, replayed: z.boolean(), receipt, current: result, completedPhase: z.literal('PROJECT_CONTROL_COMMITTED'), operationRef: stableUriSchema }).strict(),
+    tenant_project_lifecycle_set: z.object({ projectKey: projectKeySchema, replayed: z.boolean(), receipt, current: result, completedPhase: z.literal('PROJECT_CONTROL_COMMITTED'), operationRef: stableUriSchema }).strict(),
+};
+export const tenantProjectErrorSchema = tenantManagementErrorSchema.extend({ completedPhase: z.enum([...tenantManagementErrorSchema.shape.completedPhase.unwrap().options, 'PROJECT_CONTROL_COMMITTED']).optional() }).strict();
+export const tenantProjectWorkspaceToolSchemas = { ...tenantWorkspaceToolSchemas, ...tenantProjectToolSchemas };
+export const tenantProjectWorkspaceDataSchemas = { ...tenantWorkspaceDataSchemas, ...tenantProjectDataSchemas };
+export function tenantProjectScopesForInput(name, raw) { if (Object.hasOwn(tenantProjectToolSchemas, name)) {
+    tenantProjectToolSchemas[name].parse(raw);
+    return name === 'tenant_project_scope_set' ? ['knowledge.workflow.read', 'knowledge.material.scope'] : name === 'tenant_project_lifecycle_set' ? ['knowledge.workflow.read', 'knowledge.project.manage'] : name === 'tenant_project_materials' ? ['knowledge.material.read'] : ['knowledge.workflow.read'];
+} return tenantWorkspaceScopesForInput(name, raw); }
+export function tenantProjectAuthorization(name) { if (Object.hasOwn(tenantProjectToolSchemas, name)) {
+    const scopes = name === 'tenant_project_scope_set' ? ['knowledge.workflow.read', 'knowledge.material.scope'] : name === 'tenant_project_lifecycle_set' ? ['knowledge.workflow.read', 'knowledge.project.manage'] : name === 'tenant_project_materials' ? ['knowledge.material.read'] : ['knowledge.workflow.read'];
+    return { selection: 'FIXED', scopeAlternatives: [scopes] };
+} return tenantWorkspaceAuthorization(name); }
+export function tenantProjectEnvelopeSchema(tool) { return z.object({ schemaVersion: z.literal(2), tenantId: materialTenantIdSchema, tool: z.literal(tool), data: tenantProjectWorkspaceDataSchemas[tool] }).strict(); }
+export const tenantProjectInputJsonSchemas = Object.fromEntries(Object.entries(tenantProjectWorkspaceToolSchemas).map(([name, schema]) => [name, z.toJSONSchema(schema, { target: 'draft-07' })]));
+export const tenantProjectOutputJsonSchemas = Object.fromEntries(Object.keys(tenantProjectWorkspaceToolSchemas).map(name => [name, { type: 'object', oneOf: [z.toJSONSchema(tenantProjectEnvelopeSchema(name), { target: 'draft-07' }), z.toJSONSchema(tenantProjectErrorSchema, { target: 'draft-07' })] }]));
+export const tenantProjectProviderSchema = tenantManagementProviderBaseSchema.extend({ schemaVersion: z.literal(19), projectContentEndpoint: stableUriSchema, projectContentPolicyHeader: z.literal('x-knowledge-authority-policy'), projectContentProjectHeader: z.literal('x-knowledge-project-key'), projectControlIdentitySchemaVersion: z.literal(19), tools: z.array(z.string()).length(Object.keys(tenantProjectWorkspaceToolSchemas).length), capabilities: z.tuple([z.literal('TENANT_MANAGEMENT_V1'), z.literal('TENANT_WORKFLOW_V1'), z.literal('TENANT_CURRENTNESS_V2'), z.literal('TENANT_SOURCE_V1'), z.literal('TENANT_WORKSPACE_METADATA_V1'), z.literal('TENANT_PROJECT_CONTEXT_V1')]) }).strict().superRefine((value, ctx) => { if (new Set(value.tools).size !== Object.keys(tenantProjectWorkspaceToolSchemas).length || value.tools.some(name => !Object.hasOwn(tenantProjectWorkspaceToolSchemas, name)))
+    ctx.addIssue({ code: 'custom', message: 'Project workspace tools must match the exact version19 contract' }); });