@opengeni/contracts 0.35.0 → 0.36.0

package/dist/google-drive.js

@@ -1,6 +1,6 @@
 import {
   ConnectionMetadata
-} from "./chunk-JRHJTJVH.js";
+} from "./chunk-F4KMLKSL.js";
 import "./chunk-7JZMI22I.js";
 
 // src/google-drive.ts

package/dist/index.js

@@ -85,6 +85,7 @@ import {
   CreateWorkspaceArtifactRequest,
   CreateWorkspaceEnvironmentRequest,
   CreateWorkspaceInstructionPolicyDraftRequest,
+  CreateWorkspaceInstructionPolicyOnboardingProposalRequest,
   CreateWorkspaceRequest,
   CredentialAuthNeededPayload,
   DEFAULT_CODEX_FLEET_POLICY_V1,
@@ -572,6 +573,7 @@ import {
   WORKSPACE_CONTROL_EVENT_MAX_BYTES,
   WORKSPACE_CONTROL_REASON_MAX_BYTES,
   WORKSPACE_INSTRUCTION_POLICY_CONTENT_MAX_CHARS,
+  WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_SOURCE_VERSION_MAX_CHARS,
   WORKSPACE_INSTRUCTION_POLICY_PROMPT_MAX_UTF8_BYTES,
   WORKSPACE_INSTRUCTION_POLICY_REASON_MAX_CHARS,
   WORKSPACE_INSTRUCTION_POLICY_ROLE_KEY_MAX_CHARS,
@@ -622,6 +624,13 @@ import {
   WorkspaceInstructionPolicyKind,
   WorkspaceInstructionPolicyListQuery,
   WorkspaceInstructionPolicyListResponse,
+  WorkspaceInstructionPolicyOnboardingProposal,
+  WorkspaceInstructionPolicyOnboardingProposalConflictResponse,
+  WorkspaceInstructionPolicyOnboardingProposalContentErrorResponse,
+  WorkspaceInstructionPolicyOnboardingProposalListQuery,
+  WorkspaceInstructionPolicyOnboardingProposalListResponse,
+  WorkspaceInstructionPolicyOnboardingProposalSource,
+  WorkspaceInstructionPolicyOnboardingProposalStaleResponse,
   WorkspaceInstructionPolicyOperationReuseResponse,
   WorkspaceInstructionPolicyProvenance,
   WorkspaceInstructionPolicyProvenanceSource,
@@ -751,7 +760,7 @@ import {
   verifyStreamToken,
   workspaceControlUtf8Bytes,
   workspaceSlackReactionChannelAllowed
-} from "./chunk-JRHJTJVH.js";
+} from "./chunk-F4KMLKSL.js";
 import {
   OPENGENI_MANAGED_PUBLIC_BASE_URL,
   OPENGENI_SLACK_BOT_EVENTS,
@@ -852,6 +861,7 @@ export {
   CreateWorkspaceArtifactRequest,
   CreateWorkspaceEnvironmentRequest,
   CreateWorkspaceInstructionPolicyDraftRequest,
+  CreateWorkspaceInstructionPolicyOnboardingProposalRequest,
   CreateWorkspaceRequest,
   CredentialAuthNeededPayload,
   DEFAULT_CODEX_FLEET_POLICY_V1,
@@ -1346,6 +1356,7 @@ export {
   WORKSPACE_CONTROL_EVENT_MAX_BYTES,
   WORKSPACE_CONTROL_REASON_MAX_BYTES,
   WORKSPACE_INSTRUCTION_POLICY_CONTENT_MAX_CHARS,
+  WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_SOURCE_VERSION_MAX_CHARS,
   WORKSPACE_INSTRUCTION_POLICY_PROMPT_MAX_UTF8_BYTES,
   WORKSPACE_INSTRUCTION_POLICY_REASON_MAX_CHARS,
   WORKSPACE_INSTRUCTION_POLICY_ROLE_KEY_MAX_CHARS,
@@ -1396,6 +1407,13 @@ export {
   WorkspaceInstructionPolicyKind,
   WorkspaceInstructionPolicyListQuery,
   WorkspaceInstructionPolicyListResponse,
+  WorkspaceInstructionPolicyOnboardingProposal,
+  WorkspaceInstructionPolicyOnboardingProposalConflictResponse,
+  WorkspaceInstructionPolicyOnboardingProposalContentErrorResponse,
+  WorkspaceInstructionPolicyOnboardingProposalListQuery,
+  WorkspaceInstructionPolicyOnboardingProposalListResponse,
+  WorkspaceInstructionPolicyOnboardingProposalSource,
+  WorkspaceInstructionPolicyOnboardingProposalStaleResponse,
   WorkspaceInstructionPolicyOperationReuseResponse,
   WorkspaceInstructionPolicyProvenance,
   WorkspaceInstructionPolicyProvenanceSource,

package/dist/workspace-instruction-policies.d.ts

@@ -4,6 +4,7 @@ export declare const WORKSPACE_INSTRUCTION_POLICY_PROMPT_MAX_UTF8_BYTES = 131072
 export declare const WORKSPACE_INSTRUCTION_POLICY_REASON_MAX_CHARS = 4096;
 export declare const WORKSPACE_INSTRUCTION_POLICY_ROLE_KEY_MAX_CHARS = 64;
 export declare const WORKSPACE_INSTRUCTION_POLICY_SOURCE_ID_MAX_CHARS = 512;
+export declare const WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_SOURCE_VERSION_MAX_CHARS = 256;
 export declare const WorkspaceInstructionPolicyKind: z.ZodEnum<{
     charter: "charter";
     policy: "policy";
@@ -598,3 +599,215 @@ export declare const WorkspaceInstructionPolicyOperationReuseResponse: z.ZodObje
     message: z.ZodString;
 }, z.core.$strip>;
 export type WorkspaceInstructionPolicyOperationReuseResponse = z.infer<typeof WorkspaceInstructionPolicyOperationReuseResponse>;
+export declare const WorkspaceInstructionPolicyOnboardingProposalSource: z.ZodObject<{
+    id: z.ZodString;
+    version: z.ZodString;
+    confidenceBps: z.ZodNumber;
+}, z.core.$strip>;
+export type WorkspaceInstructionPolicyOnboardingProposalSource = z.infer<typeof WorkspaceInstructionPolicyOnboardingProposalSource>;
+export declare const CreateWorkspaceInstructionPolicyOnboardingProposalRequest: z.ZodObject<{
+    operationId: z.ZodOptional<z.ZodString>;
+    kind: z.ZodEnum<{
+        charter: "charter";
+        policy: "policy";
+    }>;
+    scope: z.ZodEnum<{
+        global: "global";
+        role: "role";
+    }>;
+    roleKey: z.ZodDefault<z.ZodNullable<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>>;
+    content: z.ZodString;
+    sourceId: z.ZodString;
+    sourceVersion: z.ZodString;
+    confidenceBps: z.ZodNumber;
+    expectedCurrentRevisionId: z.ZodNullable<z.ZodString>;
+    expectedActivationVersion: z.ZodNumber;
+}, z.core.$strip>;
+export type CreateWorkspaceInstructionPolicyOnboardingProposalRequest = z.infer<typeof CreateWorkspaceInstructionPolicyOnboardingProposalRequest>;
+export declare const WorkspaceInstructionPolicyOnboardingProposal: z.ZodObject<{
+    kind: z.ZodEnum<{
+        charter: "charter";
+        policy: "policy";
+    }>;
+    scope: z.ZodEnum<{
+        global: "global";
+        role: "role";
+    }>;
+    roleKey: z.ZodNullable<z.ZodString>;
+    id: z.ZodString;
+    operationId: z.ZodString;
+    accountId: z.ZodString;
+    workspaceId: z.ZodString;
+    source: z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodString;
+        confidenceBps: z.ZodNumber;
+    }, z.core.$strip>;
+    baseline: z.ZodNullable<z.ZodObject<{
+        kind: z.ZodEnum<{
+            charter: "charter";
+            policy: "policy";
+        }>;
+        scope: z.ZodEnum<{
+            global: "global";
+            role: "role";
+        }>;
+        roleKey: z.ZodNullable<z.ZodString>;
+        workspaceId: z.ZodString;
+        revisionId: z.ZodString;
+        revision: z.ZodNumber;
+        contentHash: z.ZodString;
+        activationVersion: z.ZodNumber;
+        activatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    draft: z.ZodObject<{
+        kind: z.ZodEnum<{
+            charter: "charter";
+            policy: "policy";
+        }>;
+        scope: z.ZodEnum<{
+            global: "global";
+            role: "role";
+        }>;
+        roleKey: z.ZodNullable<z.ZodString>;
+        id: z.ZodString;
+        revision: z.ZodNumber;
+        contentHash: z.ZodString;
+        operationId: z.ZodString;
+        accountId: z.ZodString;
+        workspaceId: z.ZodString;
+        content: z.ZodString;
+        provenance: z.ZodObject<{
+            source: z.ZodEnum<{
+                human: "human";
+                knowledge_proposal: "knowledge_proposal";
+                legacy_import: "legacy_import";
+                onboarding: "onboarding";
+            }>;
+            sourceId: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        supersedesRevisionId: z.ZodNullable<z.ZodString>;
+        createdBySubjectId: z.ZodString;
+        createdAt: z.ZodString;
+    }, z.core.$strip>;
+    status: z.ZodLiteral<"proposed">;
+    createdBySubjectId: z.ZodString;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type WorkspaceInstructionPolicyOnboardingProposal = z.infer<typeof WorkspaceInstructionPolicyOnboardingProposal>;
+export declare const WorkspaceInstructionPolicyOnboardingProposalListQuery: z.ZodObject<{
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type WorkspaceInstructionPolicyOnboardingProposalListQuery = z.infer<typeof WorkspaceInstructionPolicyOnboardingProposalListQuery>;
+export declare const WorkspaceInstructionPolicyOnboardingProposalListResponse: z.ZodObject<{
+    proposals: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            charter: "charter";
+            policy: "policy";
+        }>;
+        scope: z.ZodEnum<{
+            global: "global";
+            role: "role";
+        }>;
+        roleKey: z.ZodNullable<z.ZodString>;
+        id: z.ZodString;
+        operationId: z.ZodString;
+        accountId: z.ZodString;
+        workspaceId: z.ZodString;
+        source: z.ZodObject<{
+            id: z.ZodString;
+            version: z.ZodString;
+            confidenceBps: z.ZodNumber;
+        }, z.core.$strip>;
+        baseline: z.ZodNullable<z.ZodObject<{
+            kind: z.ZodEnum<{
+                charter: "charter";
+                policy: "policy";
+            }>;
+            scope: z.ZodEnum<{
+                global: "global";
+                role: "role";
+            }>;
+            roleKey: z.ZodNullable<z.ZodString>;
+            workspaceId: z.ZodString;
+            revisionId: z.ZodString;
+            revision: z.ZodNumber;
+            contentHash: z.ZodString;
+            activationVersion: z.ZodNumber;
+            activatedAt: z.ZodString;
+        }, z.core.$strip>>;
+        draft: z.ZodObject<{
+            kind: z.ZodEnum<{
+                charter: "charter";
+                policy: "policy";
+            }>;
+            scope: z.ZodEnum<{
+                global: "global";
+                role: "role";
+            }>;
+            roleKey: z.ZodNullable<z.ZodString>;
+            id: z.ZodString;
+            revision: z.ZodNumber;
+            contentHash: z.ZodString;
+            operationId: z.ZodString;
+            accountId: z.ZodString;
+            workspaceId: z.ZodString;
+            content: z.ZodString;
+            provenance: z.ZodObject<{
+                source: z.ZodEnum<{
+                    human: "human";
+                    knowledge_proposal: "knowledge_proposal";
+                    legacy_import: "legacy_import";
+                    onboarding: "onboarding";
+                }>;
+                sourceId: z.ZodNullable<z.ZodString>;
+            }, z.core.$strip>;
+            supersedesRevisionId: z.ZodNullable<z.ZodString>;
+            createdBySubjectId: z.ZodString;
+            createdAt: z.ZodString;
+        }, z.core.$strip>;
+        status: z.ZodLiteral<"proposed">;
+        createdBySubjectId: z.ZodString;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    truncated: z.ZodBoolean;
+}, z.core.$strip>;
+export type WorkspaceInstructionPolicyOnboardingProposalListResponse = z.infer<typeof WorkspaceInstructionPolicyOnboardingProposalListResponse>;
+export declare const WorkspaceInstructionPolicyOnboardingProposalContentErrorResponse: z.ZodObject<{
+    code: z.ZodEnum<{
+        WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_PROPOSAL_EMPTY: "WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_PROPOSAL_EMPTY";
+        WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_PROPOSAL_OVERSIZED: "WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_PROPOSAL_OVERSIZED";
+    }>;
+    message: z.ZodString;
+    maxChars: z.ZodNumber;
+}, z.core.$strip>;
+export type WorkspaceInstructionPolicyOnboardingProposalContentErrorResponse = z.infer<typeof WorkspaceInstructionPolicyOnboardingProposalContentErrorResponse>;
+export declare const WorkspaceInstructionPolicyOnboardingProposalStaleResponse: z.ZodObject<{
+    code: z.ZodLiteral<"WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_PROPOSAL_STALE">;
+    message: z.ZodString;
+    currentHead: z.ZodNullable<z.ZodObject<{
+        kind: z.ZodEnum<{
+            charter: "charter";
+            policy: "policy";
+        }>;
+        scope: z.ZodEnum<{
+            global: "global";
+            role: "role";
+        }>;
+        roleKey: z.ZodNullable<z.ZodString>;
+        workspaceId: z.ZodString;
+        revisionId: z.ZodString;
+        revision: z.ZodNumber;
+        contentHash: z.ZodString;
+        activationVersion: z.ZodNumber;
+        activatedAt: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type WorkspaceInstructionPolicyOnboardingProposalStaleResponse = z.infer<typeof WorkspaceInstructionPolicyOnboardingProposalStaleResponse>;
+export declare const WorkspaceInstructionPolicyOnboardingProposalConflictResponse: z.ZodObject<{
+    code: z.ZodLiteral<"WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_PROPOSAL_CONFLICT">;
+    message: z.ZodString;
+    existingProposalId: z.ZodString;
+    existingDraftRevisionId: z.ZodString;
+}, z.core.$strip>;
+export type WorkspaceInstructionPolicyOnboardingProposalConflictResponse = z.infer<typeof WorkspaceInstructionPolicyOnboardingProposalConflictResponse>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/contracts",
-  "version": "0.35.0",
+  "version": "0.36.0",
   "description": "Shared zod schemas and wire-contract types for the OpenGeni API.",
   "license": "Apache-2.0",
   "repository": {

package/src/workspace-instruction-policies.ts

@@ -5,6 +5,7 @@ export const WORKSPACE_INSTRUCTION_POLICY_PROMPT_MAX_UTF8_BYTES = 131_072;
 export const WORKSPACE_INSTRUCTION_POLICY_REASON_MAX_CHARS = 4_096;
 export const WORKSPACE_INSTRUCTION_POLICY_ROLE_KEY_MAX_CHARS = 64;
 export const WORKSPACE_INSTRUCTION_POLICY_SOURCE_ID_MAX_CHARS = 512;
+export const WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_SOURCE_VERSION_MAX_CHARS = 256;
 
 export const WorkspaceInstructionPolicyKind = z.enum(["charter", "policy"]);
 export type WorkspaceInstructionPolicyKind = z.infer<typeof WorkspaceInstructionPolicyKind>;
@@ -353,3 +354,100 @@ export const WorkspaceInstructionPolicyOperationReuseResponse = z.object({
 export type WorkspaceInstructionPolicyOperationReuseResponse = z.infer<
   typeof WorkspaceInstructionPolicyOperationReuseResponse
 >;
+
+export const WorkspaceInstructionPolicyOnboardingProposalSource = z.object({
+  id: z.string().min(1).max(WORKSPACE_INSTRUCTION_POLICY_SOURCE_ID_MAX_CHARS),
+  version: z.string().min(1).max(WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_SOURCE_VERSION_MAX_CHARS),
+  confidenceBps: z.number().int().min(0).max(10_000),
+});
+export type WorkspaceInstructionPolicyOnboardingProposalSource = z.infer<
+  typeof WorkspaceInstructionPolicyOnboardingProposalSource
+>;
+
+export const CreateWorkspaceInstructionPolicyOnboardingProposalRequest = z
+  .object({
+    operationId: z.string().uuid().optional(),
+    kind: WorkspaceInstructionPolicyKind,
+    scope: WorkspaceInstructionPolicyScope,
+    roleKey: WorkspaceInstructionPolicyRoleKeyInput.nullable().default(null),
+    // Content bounds are enforced by the domain layer so empty and oversized
+    // proposals retain their typed API outcomes instead of collapsing into a
+    // generic request-shape error.
+    content: z.string(),
+    sourceId: z.string().trim().min(1).max(WORKSPACE_INSTRUCTION_POLICY_SOURCE_ID_MAX_CHARS),
+    sourceVersion: z
+      .string()
+      .trim()
+      .min(1)
+      .max(WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_SOURCE_VERSION_MAX_CHARS),
+    confidenceBps: z.number().int().min(0).max(10_000),
+    expectedCurrentRevisionId: z.string().uuid().nullable(),
+    expectedActivationVersion: z.number().int().nonnegative(),
+  })
+  .superRefine(validateTarget);
+export type CreateWorkspaceInstructionPolicyOnboardingProposalRequest = z.infer<
+  typeof CreateWorkspaceInstructionPolicyOnboardingProposalRequest
+>;
+
+export const WorkspaceInstructionPolicyOnboardingProposal = z.object({
+  id: z.string().uuid(),
+  operationId: z.string().uuid(),
+  accountId: z.string().uuid(),
+  workspaceId: z.string().uuid(),
+  ...targetShape,
+  source: WorkspaceInstructionPolicyOnboardingProposalSource,
+  baseline: WorkspaceInstructionPolicyHead.nullable(),
+  draft: WorkspaceInstructionPolicyRevision,
+  status: z.literal("proposed"),
+  createdBySubjectId: z.string().min(1),
+  createdAt: z.string().datetime(),
+});
+export type WorkspaceInstructionPolicyOnboardingProposal = z.infer<
+  typeof WorkspaceInstructionPolicyOnboardingProposal
+>;
+
+export const WorkspaceInstructionPolicyOnboardingProposalListQuery = z.object({
+  limit: z.coerce.number().int().min(1).max(100).default(50),
+});
+export type WorkspaceInstructionPolicyOnboardingProposalListQuery = z.infer<
+  typeof WorkspaceInstructionPolicyOnboardingProposalListQuery
+>;
+
+export const WorkspaceInstructionPolicyOnboardingProposalListResponse = z.object({
+  proposals: z.array(WorkspaceInstructionPolicyOnboardingProposal),
+  truncated: z.boolean(),
+});
+export type WorkspaceInstructionPolicyOnboardingProposalListResponse = z.infer<
+  typeof WorkspaceInstructionPolicyOnboardingProposalListResponse
+>;
+
+export const WorkspaceInstructionPolicyOnboardingProposalContentErrorResponse = z.object({
+  code: z.enum([
+    "WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_PROPOSAL_EMPTY",
+    "WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_PROPOSAL_OVERSIZED",
+  ]),
+  message: z.string(),
+  maxChars: z.number().int().positive(),
+});
+export type WorkspaceInstructionPolicyOnboardingProposalContentErrorResponse = z.infer<
+  typeof WorkspaceInstructionPolicyOnboardingProposalContentErrorResponse
+>;
+
+export const WorkspaceInstructionPolicyOnboardingProposalStaleResponse = z.object({
+  code: z.literal("WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_PROPOSAL_STALE"),
+  message: z.string(),
+  currentHead: WorkspaceInstructionPolicyHead.nullable(),
+});
+export type WorkspaceInstructionPolicyOnboardingProposalStaleResponse = z.infer<
+  typeof WorkspaceInstructionPolicyOnboardingProposalStaleResponse
+>;
+
+export const WorkspaceInstructionPolicyOnboardingProposalConflictResponse = z.object({
+  code: z.literal("WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_PROPOSAL_CONFLICT"),
+  message: z.string(),
+  existingProposalId: z.string().uuid(),
+  existingDraftRevisionId: z.string().uuid(),
+});
+export type WorkspaceInstructionPolicyOnboardingProposalConflictResponse = z.infer<
+  typeof WorkspaceInstructionPolicyOnboardingProposalConflictResponse
+>;