@opengeni/contracts 3.1.0-canary.1 → 3.1.2

package/dist/agent-instruction-changes.d.ts

@@ -0,0 +1,110 @@
+import { z } from "zod";
+export declare const AgentInstructionEditMode: z.ZodEnum<{
+    append: "append";
+    edit: "edit";
+}>;
+export type AgentInstructionEditMode = z.infer<typeof AgentInstructionEditMode>;
+export declare const AgentInstructionSaveRequest: z.ZodObject<{
+    operationId: z.ZodUUID;
+    target: z.ZodObject<{
+        kind: z.ZodEnum<{
+            charter: "charter";
+            policy: "policy";
+        }>;
+        scope: z.ZodEnum<{
+            global: "global";
+            role: "role";
+        }>;
+        roleKey: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    editMode: z.ZodEnum<{
+        append: "append";
+        edit: "edit";
+    }>;
+    content: z.ZodOptional<z.ZodString>;
+    oldText: z.ZodOptional<z.ZodString>;
+    newText: z.ZodOptional<z.ZodString>;
+    expectedCurrentRevisionId: z.ZodNullable<z.ZodUUID>;
+    expectedActivationVersion: z.ZodNumber;
+    evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        entryId: z.ZodUUID;
+        revisionId: z.ZodUUID;
+        location: z.ZodDefault<z.ZodObject<{
+            page: z.ZodOptional<z.ZodNumber>;
+            passage: z.ZodOptional<z.ZodString>;
+            messageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            path: z.ZodOptional<z.ZodString>;
+            commit: z.ZodOptional<z.ZodString>;
+            lineStart: z.ZodOptional<z.ZodNumber>;
+            lineEnd: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        quote: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    reason: z.ZodString;
+}, z.core.$strict>;
+export type AgentInstructionSaveRequest = z.input<typeof AgentInstructionSaveRequest>;
+export declare const AgentInstructionReviewRequest: z.ZodObject<{
+    operationId: z.ZodUUID;
+    revisionId: z.ZodUUID;
+    decision: z.ZodEnum<{
+        approve: "approve";
+        reject: "reject";
+    }>;
+    reason: z.ZodString;
+}, z.core.$strict>;
+export type AgentInstructionReviewRequest = z.infer<typeof AgentInstructionReviewRequest>;
+export declare const AgentInstructionReceipt: z.ZodObject<{
+    operationId: z.ZodUUID;
+    revisionId: z.ZodUUID;
+    outcome: z.ZodEnum<{
+        pending: "pending";
+        published: "published";
+        rejected: "rejected";
+    }>;
+    reviewBatchId: z.ZodNullable<z.ZodUUID>;
+    replayed: z.ZodBoolean;
+}, z.core.$strip>;
+export type AgentInstructionReceipt = z.infer<typeof AgentInstructionReceipt>;
+export declare const AgentInstructionReviewItem: z.ZodObject<{
+    revisionId: z.ZodUUID;
+    content: z.ZodString;
+    target: z.ZodObject<{
+        kind: z.ZodEnum<{
+            charter: "charter";
+            policy: "policy";
+        }>;
+        scope: z.ZodEnum<{
+            global: "global";
+            role: "role";
+        }>;
+        roleKey: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    reviewBatchId: z.ZodNullable<z.ZodUUID>;
+    sessionId: z.ZodNullable<z.ZodUUID>;
+    reason: z.ZodString;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+export type AgentInstructionReviewItem = z.infer<typeof AgentInstructionReviewItem>;
+export declare const AgentInstructionReviewListResponse: z.ZodObject<{
+    entries: z.ZodArray<z.ZodObject<{
+        revisionId: z.ZodUUID;
+        content: z.ZodString;
+        target: z.ZodObject<{
+            kind: z.ZodEnum<{
+                charter: "charter";
+                policy: "policy";
+            }>;
+            scope: z.ZodEnum<{
+                global: "global";
+                role: "role";
+            }>;
+            roleKey: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        reviewBatchId: z.ZodNullable<z.ZodUUID>;
+        sessionId: z.ZodNullable<z.ZodUUID>;
+        reason: z.ZodString;
+        createdAt: z.ZodString;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type AgentInstructionReviewListResponse = z.infer<typeof AgentInstructionReviewListResponse>;

package/dist/agent-learning.d.ts

@@ -0,0 +1,243 @@
+import { z } from "zod";
+/** Review controls publication. It never grants content or external-action authority. */
+export declare const AgentLearningMode: z.ZodEnum<{
+    automatic: "automatic";
+    off: "off";
+    review_first: "review_first";
+}>;
+export type AgentLearningMode = z.infer<typeof AgentLearningMode>;
+export declare const AgentLearningCategory: z.ZodEnum<{
+    instructions: "instructions";
+    knowledge: "knowledge";
+    skills: "skills";
+}>;
+export type AgentLearningCategory = z.infer<typeof AgentLearningCategory>;
+export declare const AgentLearningDefaults: z.ZodObject<{
+    knowledge: z.ZodEnum<{
+        automatic: "automatic";
+        off: "off";
+        review_first: "review_first";
+    }>;
+    instructions: z.ZodEnum<{
+        automatic: "automatic";
+        off: "off";
+        review_first: "review_first";
+    }>;
+    skills: z.ZodEnum<{
+        automatic: "automatic";
+        off: "off";
+        review_first: "review_first";
+    }>;
+}, z.core.$strict>;
+export type AgentLearningDefaults = z.infer<typeof AgentLearningDefaults>;
+export declare const DEFAULT_AGENT_LEARNING: Readonly<AgentLearningDefaults>;
+/** An absent category inherits. `inherit` is a reset request, not persisted policy. */
+export declare const AgentLearningOverrides: z.ZodObject<{
+    knowledge: z.ZodOptional<z.ZodEnum<{
+        automatic: "automatic";
+        off: "off";
+        review_first: "review_first";
+    }>>;
+    instructions: z.ZodOptional<z.ZodEnum<{
+        automatic: "automatic";
+        off: "off";
+        review_first: "review_first";
+    }>>;
+    skills: z.ZodOptional<z.ZodEnum<{
+        automatic: "automatic";
+        off: "off";
+        review_first: "review_first";
+    }>>;
+}, z.core.$strict>;
+export type AgentLearningOverrides = z.infer<typeof AgentLearningOverrides>;
+export declare const AgentLearningOverridePatch: z.ZodObject<{
+    knowledge: z.ZodOptional<z.ZodUnion<[z.ZodEnum<{
+        automatic: "automatic";
+        off: "off";
+        review_first: "review_first";
+    }>, z.ZodLiteral<"inherit">]>>;
+    instructions: z.ZodOptional<z.ZodUnion<[z.ZodEnum<{
+        automatic: "automatic";
+        off: "off";
+        review_first: "review_first";
+    }>, z.ZodLiteral<"inherit">]>>;
+    skills: z.ZodOptional<z.ZodUnion<[z.ZodEnum<{
+        automatic: "automatic";
+        off: "off";
+        review_first: "review_first";
+    }>, z.ZodLiteral<"inherit">]>>;
+}, z.core.$strict>;
+export type AgentLearningOverridePatch = z.infer<typeof AgentLearningOverridePatch>;
+export declare const AgentLearningContext: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"chat">;
+    id: z.ZodUUID;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"scheduled_task">;
+    id: z.ZodUUID;
+}, z.core.$strict>], "kind">;
+export type AgentLearningContext = z.infer<typeof AgentLearningContext>;
+export declare const AgentLearningOwner: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"workspace">;
+    workspaceId: z.ZodUUID;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"personal">;
+    subjectId: z.ZodString;
+}, z.core.$strict>], "kind">;
+export type AgentLearningOwner = z.infer<typeof AgentLearningOwner>;
+export declare const AgentLearningSettings: z.ZodObject<{
+    owner: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"workspace">;
+        workspaceId: z.ZodUUID;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"personal">;
+        subjectId: z.ZodString;
+    }, z.core.$strict>], "kind">;
+    version: z.ZodNumber;
+    defaults: z.ZodObject<{
+        knowledge: z.ZodEnum<{
+            automatic: "automatic";
+            off: "off";
+            review_first: "review_first";
+        }>;
+        instructions: z.ZodEnum<{
+            automatic: "automatic";
+            off: "off";
+            review_first: "review_first";
+        }>;
+        skills: z.ZodEnum<{
+            automatic: "automatic";
+            off: "off";
+            review_first: "review_first";
+        }>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type AgentLearningSettings = z.infer<typeof AgentLearningSettings>;
+export declare const AgentLearningContextSettings: z.ZodObject<{
+    context: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"chat">;
+        id: z.ZodUUID;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"scheduled_task">;
+        id: z.ZodUUID;
+    }, z.core.$strict>], "kind">;
+    version: z.ZodNumber;
+    overrides: z.ZodObject<{
+        knowledge: z.ZodOptional<z.ZodEnum<{
+            automatic: "automatic";
+            off: "off";
+            review_first: "review_first";
+        }>>;
+        instructions: z.ZodOptional<z.ZodEnum<{
+            automatic: "automatic";
+            off: "off";
+            review_first: "review_first";
+        }>>;
+        skills: z.ZodOptional<z.ZodEnum<{
+            automatic: "automatic";
+            off: "off";
+            review_first: "review_first";
+        }>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type AgentLearningContextSettings = z.infer<typeof AgentLearningContextSettings>;
+/** Versioned settings returned by both central and contextual editors. */
+export declare const AgentLearningSettingsRecord: z.ZodObject<{
+    ownerKey: z.ZodString;
+    contextKey: z.ZodString;
+    version: z.ZodNumber;
+    settings: z.ZodObject<{
+        knowledge: z.ZodOptional<z.ZodEnum<{
+            automatic: "automatic";
+            off: "off";
+            review_first: "review_first";
+        }>>;
+        instructions: z.ZodOptional<z.ZodEnum<{
+            automatic: "automatic";
+            off: "off";
+            review_first: "review_first";
+        }>>;
+        skills: z.ZodOptional<z.ZodEnum<{
+            automatic: "automatic";
+            off: "off";
+            review_first: "review_first";
+        }>>;
+    }, z.core.$strict>;
+}, z.core.$strip>;
+export type AgentLearningSettingsRecord = z.infer<typeof AgentLearningSettingsRecord>;
+export declare const AgentLearningOverrideRecord: z.ZodObject<{
+    contextKey: z.ZodString;
+    version: z.ZodNumber;
+    settings: z.ZodObject<{
+        knowledge: z.ZodOptional<z.ZodEnum<{
+            automatic: "automatic";
+            off: "off";
+            review_first: "review_first";
+        }>>;
+        instructions: z.ZodOptional<z.ZodEnum<{
+            automatic: "automatic";
+            off: "off";
+            review_first: "review_first";
+        }>>;
+        skills: z.ZodOptional<z.ZodEnum<{
+            automatic: "automatic";
+            off: "off";
+            review_first: "review_first";
+        }>>;
+    }, z.core.$strict>;
+    updatedAt: z.ZodString;
+    label: z.ZodString;
+}, z.core.$strip>;
+export type AgentLearningOverrideRecord = z.infer<typeof AgentLearningOverrideRecord>;
+export type SaveAgentLearningSettingsRequest = {
+    scope: "workspace" | "personal";
+    source?: AgentLearningContext;
+    operationId: string;
+    expectedVersion: number;
+    settings: AgentLearningOverridePatch;
+};
+export declare const AgentLearningEffectiveCategory: z.ZodObject<{
+    mode: z.ZodEnum<{
+        automatic: "automatic";
+        off: "off";
+        review_first: "review_first";
+    }>;
+    inherited: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const AgentLearningEffectivePolicy: z.ZodObject<{
+    knowledge: z.ZodObject<{
+        mode: z.ZodEnum<{
+            automatic: "automatic";
+            off: "off";
+            review_first: "review_first";
+        }>;
+        inherited: z.ZodBoolean;
+    }, z.core.$strict>;
+    instructions: z.ZodObject<{
+        mode: z.ZodEnum<{
+            automatic: "automatic";
+            off: "off";
+            review_first: "review_first";
+        }>;
+        inherited: z.ZodBoolean;
+    }, z.core.$strict>;
+    skills: z.ZodObject<{
+        mode: z.ZodEnum<{
+            automatic: "automatic";
+            off: "off";
+            review_first: "review_first";
+        }>;
+        inherited: z.ZodBoolean;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type AgentLearningEffectivePolicy = z.infer<typeof AgentLearningEffectivePolicy>;
+/** Apply only at an authorized settings boundary; this function confers no authority. */
+export declare function patchAgentLearningOverrides(current: AgentLearningOverrides, patch: AgentLearningOverridePatch): AgentLearningOverrides;
+/** Pure resolution over accepted settings. Runtime callers persist the resulting snapshot. */
+export declare function resolveAgentLearningPolicy(defaults: AgentLearningDefaults, overrides: AgentLearningOverrides): AgentLearningEffectivePolicy;
+/** Migration adapter preserves explicit opt-outs and existing instruction/Skill choices. */
+export declare function agentLearningDefaultsFromLegacy(input: {
+    memoryEnabled?: boolean;
+    workspaceMode?: "off" | "suggest" | "automatic";
+}): AgentLearningDefaults;
+/** Existing instruction and Skill lifecycles retain their native mode vocabulary. */
+export declare function agentLearningDestinationMode(mode: AgentLearningMode): "automatic" | "off" | "suggest";

package/dist/allowance-refusal.d.ts

@@ -0,0 +1,9 @@
+import type { AllowanceExhaustedRefusal } from "./usage-allowances.js";
+/** Select only public refusal fields, including from an API error's details.
+ * LimitDecision's allowed:false and transport/SQL diagnostics never cross out.
+ */
+export declare function parseAllowanceExhaustedRefusal(value: unknown): AllowanceExhaustedRefusal | null;
+/** Bounded, fixed remedies: a ceiling is not an exhausted billing source.
+ * Never interpolate arbitrary exception prose or a member identifier.
+ */
+export declare function allowanceExhaustedMessage(refusal: AllowanceExhaustedRefusal): string;

package/dist/allowance-refusal.js

@@ -0,0 +1,50 @@
+// src/allowance-refusal.ts
+var MESSAGE_MAX_UTF8_BYTES = 1024;
+function record(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function resetTimestamp(value) {
+  if (value === null) return true;
+  if (typeof value !== "string" || value.length > 64) return false;
+  const parts = /^(\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])T(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$/.exec(
+    value
+  );
+  if (!parts || !Number.isFinite(Date.parse(value))) return false;
+  const year = Number(parts[1]);
+  const month = Number(parts[2]);
+  const day = Number(parts[3]);
+  const leapYear = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+  const days = [31, leapYear ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+  return day <= days[month - 1];
+}
+function parseAllowanceExhaustedRefusal(value) {
+  const source = record(value);
+  if (source?.code !== "allowance_exhausted") return null;
+  const fields = record(source.details) ?? source;
+  const scope = fields.scope;
+  const subjectId = scope === "member" ? fields.subjectId : void 0;
+  if (typeof source.message !== "string" || scope !== "workspace" && scope !== "member" || !resetTimestamp(fields.resetsAt) || subjectId !== void 0 && (typeof subjectId !== "string" || subjectId.length === 0 || subjectId.length > 1024 || subjectId.includes("\0"))) {
+    return null;
+  }
+  const normalized = source.message.slice(0, MESSAGE_MAX_UTF8_BYTES * 2).replace(/[\u0000-\u001f\u007f]+/g, " ").trim();
+  const bytes = new TextEncoder().encode(normalized.slice(0, MESSAGE_MAX_UTF8_BYTES * 2));
+  let end = Math.min(bytes.length, MESSAGE_MAX_UTF8_BYTES);
+  while (end > 0 && end < bytes.length && (bytes[end] & 192) === 128) end -= 1;
+  return {
+    code: "allowance_exhausted",
+    scope,
+    resetsAt: fields.resetsAt,
+    ...typeof subjectId === "string" ? { subjectId } : {},
+    message: new TextDecoder().decode(bytes.slice(0, end)).trim()
+  };
+}
+function allowanceExhaustedMessage(refusal) {
+  const remedy = refusal.scope === "workspace" ? "The workspace usage allowance is exhausted. An organization administrator or a full-access organization API key can raise the workspace ceiling or add an allowance grant." : "The member usage allowance is exhausted. A workspace administrator or a full-access organization API key can adjust the member ceiling.";
+  const reset = refusal.resetsAt === null ? "This allowance has no automatic reset." : `It resets at ${new Date(refusal.resetsAt).toISOString().slice(0, 16).replace("T", " ")} UTC.`;
+  return `${remedy} ${reset}`;
+}
+export {
+  allowanceExhaustedMessage,
+  parseAllowanceExhaustedRefusal
+};
+//# sourceMappingURL=allowance-refusal.js.map

package/dist/allowance-refusal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/allowance-refusal.ts"],"sourcesContent":["import type { AllowanceExhaustedRefusal } from \"./usage-allowances\";\n\nconst MESSAGE_MAX_UTF8_BYTES = 1_024;\n\nfunction record(value: unknown): Record<string, unknown> | null {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null;\n}\n\n/** Mirror the canonical offset datetime's calendar/time bounds without loading\n * the schema runtime into synchronous browser/React Native session projection.\n * Contract-parity tests guard this deliberately small, bounded wire leaf.\n */\nfunction resetTimestamp(value: unknown): value is string | null {\n  if (value === null) return true;\n  if (typeof value !== \"string\" || value.length > 64) return false;\n  const parts =\n    /^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])T(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$/.exec(\n      value,\n    );\n  if (!parts || !Number.isFinite(Date.parse(value))) return false;\n  const year = Number(parts[1]);\n  const month = Number(parts[2]);\n  const day = Number(parts[3]);\n  const leapYear = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);\n  const days = [31, leapYear ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];\n  return day <= days[month - 1]!;\n}\n\n/** Select only public refusal fields, including from an API error's details.\n * LimitDecision's allowed:false and transport/SQL diagnostics never cross out.\n */\nexport function parseAllowanceExhaustedRefusal(value: unknown): AllowanceExhaustedRefusal | null {\n  const source = record(value);\n  if (source?.code !== \"allowance_exhausted\") return null;\n  const fields = record(source.details) ?? source;\n  const scope = fields.scope;\n  const subjectId = scope === \"member\" ? fields.subjectId : undefined;\n  if (\n    typeof source.message !== \"string\" ||\n    (scope !== \"workspace\" && scope !== \"member\") ||\n    !resetTimestamp(fields.resetsAt) ||\n    (subjectId !== undefined &&\n      (typeof subjectId !== \"string\" ||\n        subjectId.length === 0 ||\n        subjectId.length > 1_024 ||\n        subjectId.includes(\"\\0\")))\n  ) {\n    return null;\n  }\n  const normalized = source.message\n    .slice(0, MESSAGE_MAX_UTF8_BYTES * 2)\n    .replace(/[\\u0000-\\u001f\\u007f]+/g, \" \")\n    .trim();\n  const bytes = new TextEncoder().encode(normalized.slice(0, MESSAGE_MAX_UTF8_BYTES * 2));\n  let end = Math.min(bytes.length, MESSAGE_MAX_UTF8_BYTES);\n  while (end > 0 && end < bytes.length && (bytes[end]! & 0xc0) === 0x80) end -= 1;\n  return {\n    code: \"allowance_exhausted\",\n    scope,\n    resetsAt: fields.resetsAt,\n    ...(typeof subjectId === \"string\" ? { subjectId } : {}),\n    message: new TextDecoder().decode(bytes.slice(0, end)).trim(),\n  };\n}\n\n/** Bounded, fixed remedies: a ceiling is not an exhausted billing source.\n * Never interpolate arbitrary exception prose or a member identifier.\n */\nexport function allowanceExhaustedMessage(refusal: AllowanceExhaustedRefusal): string {\n  const remedy =\n    refusal.scope === \"workspace\"\n      ? \"The workspace usage allowance is exhausted. An organization administrator or a full-access organization API key can raise the workspace ceiling or add an allowance grant.\"\n      : \"The member usage allowance is exhausted. A workspace administrator or a full-access organization API key can adjust the member ceiling.\";\n  const reset =\n    refusal.resetsAt === null\n      ? \"This allowance has no automatic reset.\"\n      : `It resets at ${new Date(refusal.resetsAt).toISOString().slice(0, 16).replace(\"T\", \" \")} UTC.`;\n  return `${remedy} ${reset}`;\n}\n"],"mappings":";AAEA,IAAM,yBAAyB;AAE/B,SAAS,OAAO,OAAgD;AAC9D,SAAO,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK,IACrE,QACD;AACN;AAMA,SAAS,eAAe,OAAwC;AAC9D,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,OAAO,UAAU,YAAY,MAAM,SAAS,GAAI,QAAO;AAC3D,QAAM,QACJ,sIAAsI;AAAA,IACpI;AAAA,EACF;AACF,MAAI,CAAC,SAAS,CAAC,OAAO,SAAS,KAAK,MAAM,KAAK,CAAC,EAAG,QAAO;AAC1D,QAAM,OAAO,OAAO,MAAM,CAAC,CAAC;AAC5B,QAAM,QAAQ,OAAO,MAAM,CAAC,CAAC;AAC7B,QAAM,MAAM,OAAO,MAAM,CAAC,CAAC;AAC3B,QAAM,WAAW,OAAO,MAAM,MAAM,OAAO,QAAQ,KAAK,OAAO,QAAQ;AACvE,QAAM,OAAO,CAAC,IAAI,WAAW,KAAK,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE;AAC5E,SAAO,OAAO,KAAK,QAAQ,CAAC;AAC9B;AAKO,SAAS,+BAA+B,OAAkD;AAC/F,QAAM,SAAS,OAAO,KAAK;AAC3B,MAAI,QAAQ,SAAS,sBAAuB,QAAO;AACnD,QAAM,SAAS,OAAO,OAAO,OAAO,KAAK;AACzC,QAAM,QAAQ,OAAO;AACrB,QAAM,YAAY,UAAU,WAAW,OAAO,YAAY;AAC1D,MACE,OAAO,OAAO,YAAY,YACzB,UAAU,eAAe,UAAU,YACpC,CAAC,eAAe,OAAO,QAAQ,KAC9B,cAAc,WACZ,OAAO,cAAc,YACpB,UAAU,WAAW,KACrB,UAAU,SAAS,QACnB,UAAU,SAAS,IAAI,IAC3B;AACA,WAAO;AAAA,EACT;AACA,QAAM,aAAa,OAAO,QACvB,MAAM,GAAG,yBAAyB,CAAC,EACnC,QAAQ,2BAA2B,GAAG,EACtC,KAAK;AACR,QAAM,QAAQ,IAAI,YAAY,EAAE,OAAO,WAAW,MAAM,GAAG,yBAAyB,CAAC,CAAC;AACtF,MAAI,MAAM,KAAK,IAAI,MAAM,QAAQ,sBAAsB;AACvD,SAAO,MAAM,KAAK,MAAM,MAAM,WAAW,MAAM,GAAG,IAAK,SAAU,IAAM,QAAO;AAC9E,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,UAAU,OAAO;AAAA,IACjB,GAAI,OAAO,cAAc,WAAW,EAAE,UAAU,IAAI,CAAC;AAAA,IACrD,SAAS,IAAI,YAAY,EAAE,OAAO,MAAM,MAAM,GAAG,GAAG,CAAC,EAAE,KAAK;AAAA,EAC9D;AACF;AAKO,SAAS,0BAA0B,SAA4C;AACpF,QAAM,SACJ,QAAQ,UAAU,cACd,+KACA;AACN,QAAM,QACJ,QAAQ,aAAa,OACjB,2CACA,gBAAgB,IAAI,KAAK,QAAQ,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE,EAAE,QAAQ,KAAK,GAAG,CAAC;AAC7F,SAAO,GAAG,MAAM,IAAI,KAAK;AAC3B;","names":[]}

package/dist/analytics-consent-report.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Wire grammar of the content-free analytics consent beacon
+ * (`POST /v1/analytics-consent`).
+ *
+ * When a person answers the web console's optional-analytics banner, the
+ * browser reports only the closed decision so the API can count choices in
+ * `opengeni_analytics_consent_total{decision}`. The count shows how much of
+ * the audience the consent-gated analytics providers never see. A report
+ * carries no identifier, URL, cookie, or user content, and the web client and
+ * the API route both validate against these exact values.
+ */
+export declare const ANALYTICS_CONSENT_PATH = "/v1/analytics-consent";
+export declare const ANALYTICS_CONSENT_DECISIONS: readonly ["granted", "denied"];
+export type AnalyticsConsentDecision = (typeof ANALYTICS_CONSENT_DECISIONS)[number];
+/** Largest accepted report body. A valid report is under 32 bytes. */
+export declare const ANALYTICS_CONSENT_REPORT_MAX_BYTES = 128;
+export type AnalyticsConsentReport = {
+    decision: AnalyticsConsentDecision;
+};

package/dist/analytics-consent-report.js

@@ -0,0 +1,10 @@
+// src/analytics-consent-report.ts
+var ANALYTICS_CONSENT_PATH = "/v1/analytics-consent";
+var ANALYTICS_CONSENT_DECISIONS = ["granted", "denied"];
+var ANALYTICS_CONSENT_REPORT_MAX_BYTES = 128;
+export {
+  ANALYTICS_CONSENT_DECISIONS,
+  ANALYTICS_CONSENT_PATH,
+  ANALYTICS_CONSENT_REPORT_MAX_BYTES
+};
+//# sourceMappingURL=analytics-consent-report.js.map

package/dist/analytics-consent-report.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/analytics-consent-report.ts"],"sourcesContent":["/**\n * Wire grammar of the content-free analytics consent beacon\n * (`POST /v1/analytics-consent`).\n *\n * When a person answers the web console's optional-analytics banner, the\n * browser reports only the closed decision so the API can count choices in\n * `opengeni_analytics_consent_total{decision}`. The count shows how much of\n * the audience the consent-gated analytics providers never see. A report\n * carries no identifier, URL, cookie, or user content, and the web client and\n * the API route both validate against these exact values.\n */\nexport const ANALYTICS_CONSENT_PATH = \"/v1/analytics-consent\";\n\nexport const ANALYTICS_CONSENT_DECISIONS = [\"granted\", \"denied\"] as const;\nexport type AnalyticsConsentDecision = (typeof ANALYTICS_CONSENT_DECISIONS)[number];\n\n/** Largest accepted report body. A valid report is under 32 bytes. */\nexport const ANALYTICS_CONSENT_REPORT_MAX_BYTES = 128;\n\nexport type AnalyticsConsentReport = { decision: AnalyticsConsentDecision };\n"],"mappings":";AAWO,IAAM,yBAAyB;AAE/B,IAAM,8BAA8B,CAAC,WAAW,QAAQ;AAIxD,IAAM,qCAAqC;","names":[]}

package/dist/api-key-presets.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+/** Optional creation alias for the developer_setup organization access tier. */
+export declare const OrganizationApiKeyPreset: z.ZodEnum<{
+    developer_setup: "developer_setup";
+}>;
+export type OrganizationApiKeyPreset = z.infer<typeof OrganizationApiKeyPreset>;
+/**
+ * The current setup-route floor: workspace provisioning, configuration/cleanup,
+ * and explicit literal budget authority. workspace:admin also covers discovery and session/tool/
+ * schedule guards. It is broad authority, not setup-only, and never confers
+ * literal secrets:read. No account:admin, billing, or redundant read scopes.
+ */
+export declare const DEVELOPER_SETUP_API_KEY_PRESET: {
+    readonly id: "developer_setup";
+    readonly label: "Developer setup";
+    readonly description: "Set up shared workspaces, tools and budgets. Includes broad workspace administration and expires after 24 hours. Can't manage API keys.";
+    readonly permissions: ("usage_allowances:manage" | "workspace:admin" | "workspace:create")[];
+    readonly defaultExpiryHours: 24;
+};

package/dist/artifact-catalog.d.ts

@@ -0,0 +1,188 @@
+import { z } from "zod";
+export declare const ArtifactCatalogKind: z.ZodEnum<{
+    document: "document";
+    file: "file";
+    image: "image";
+    presentation: "presentation";
+    site: "site";
+    spreadsheet: "spreadsheet";
+}>;
+export type ArtifactCatalogKind = z.infer<typeof ArtifactCatalogKind>;
+/** Metadata only: native domain IDs, never content, storage keys or credentials. */
+export declare const ArtifactCatalogItem: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        document: "document";
+        file: "file";
+        image: "image";
+        presentation: "presentation";
+        site: "site";
+        spreadsheet: "spreadsheet";
+    }>;
+    title: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        archived: "archived";
+    }>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
+    visibility: z.ZodOptional<z.ZodEnum<{
+        private: "private";
+        workspace: "workspace";
+    }>>;
+    sourceSessionId: z.ZodOptional<z.ZodString>;
+    versionId: z.ZodOptional<z.ZodString>;
+    file: z.ZodOptional<z.ZodObject<{
+        available: z.ZodLiteral<true>;
+        artifactId: z.ZodString;
+        kind: z.ZodEnum<{
+            assistant_completion: "assistant_completion";
+            browser_screenshot: "browser_screenshot";
+            computer_screenshot: "computer_screenshot";
+            event_media: "event_media";
+            file: "file";
+            generated_image: "generated_image";
+            generated_video: "generated_video";
+            internal_update: "internal_update";
+            tool_result: "tool_result";
+        }>;
+        contentType: z.ZodString;
+        originalBytes: z.ZodNumber;
+        sha256: z.ZodString;
+        retainedAt: z.ZodString;
+        dimensions: z.ZodOptional<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strict>>;
+        retention: z.ZodUnion<readonly [z.ZodObject<{
+            policy: z.ZodLiteral<"workspace_file">;
+            expiresAt: z.ZodNull;
+        }, z.core.$strict>, z.ZodObject<{
+            policy: z.ZodLiteral<"session_screenshot">;
+            expiresAt: z.ZodString;
+        }, z.core.$strict>]>;
+        retrieval: z.ZodObject<{
+            method: z.ZodLiteral<"GET">;
+            path: z.ZodString;
+            acceptRanges: z.ZodLiteral<"bytes">;
+            maxRangeBytes: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    filename: z.ZodOptional<z.ZodString>;
+    contentType: z.ZodOptional<z.ZodString>;
+    sizeBytes: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type ArtifactCatalogItem = z.infer<typeof ArtifactCatalogItem>;
+export declare const ArtifactCatalogListQuery: z.ZodObject<{
+    sourceSessionId: z.ZodOptional<z.ZodString>;
+    q: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodEnum<{
+        document: "document";
+        file: "file";
+        image: "image";
+        presentation: "presentation";
+        site: "site";
+        spreadsheet: "spreadsheet";
+    }>>;
+    sort: z.ZodDefault<z.ZodEnum<{
+        newest: "newest";
+        title: "title";
+        updated: "updated";
+    }>>;
+    status: z.ZodDefault<z.ZodEnum<{
+        active: "active";
+        archived: "archived";
+    }>>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ArtifactCatalogListQuery = z.infer<typeof ArtifactCatalogListQuery>;
+export type ArtifactCatalogListOptions = Omit<z.input<typeof ArtifactCatalogListQuery>, "limit"> & {
+    limit?: number;
+};
+export declare const ArtifactCatalogListResponse: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            document: "document";
+            file: "file";
+            image: "image";
+            presentation: "presentation";
+            site: "site";
+            spreadsheet: "spreadsheet";
+        }>;
+        title: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        status: z.ZodEnum<{
+            active: "active";
+            archived: "archived";
+        }>;
+        pinned: z.ZodOptional<z.ZodBoolean>;
+        visibility: z.ZodOptional<z.ZodEnum<{
+            private: "private";
+            workspace: "workspace";
+        }>>;
+        sourceSessionId: z.ZodOptional<z.ZodString>;
+        versionId: z.ZodOptional<z.ZodString>;
+        file: z.ZodOptional<z.ZodObject<{
+            available: z.ZodLiteral<true>;
+            artifactId: z.ZodString;
+            kind: z.ZodEnum<{
+                assistant_completion: "assistant_completion";
+                browser_screenshot: "browser_screenshot";
+                computer_screenshot: "computer_screenshot";
+                event_media: "event_media";
+                file: "file";
+                generated_image: "generated_image";
+                generated_video: "generated_video";
+                internal_update: "internal_update";
+                tool_result: "tool_result";
+            }>;
+            contentType: z.ZodString;
+            originalBytes: z.ZodNumber;
+            sha256: z.ZodString;
+            retainedAt: z.ZodString;
+            dimensions: z.ZodOptional<z.ZodObject<{
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>>;
+            retention: z.ZodUnion<readonly [z.ZodObject<{
+                policy: z.ZodLiteral<"workspace_file">;
+                expiresAt: z.ZodNull;
+            }, z.core.$strict>, z.ZodObject<{
+                policy: z.ZodLiteral<"session_screenshot">;
+                expiresAt: z.ZodString;
+            }, z.core.$strict>]>;
+            retrieval: z.ZodObject<{
+                method: z.ZodLiteral<"GET">;
+                path: z.ZodString;
+                acceptRanges: z.ZodLiteral<"bytes">;
+                maxRangeBytes: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        filename: z.ZodOptional<z.ZodString>;
+        contentType: z.ZodOptional<z.ZodString>;
+        sizeBytes: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type ArtifactCatalogListResponse = z.infer<typeof ArtifactCatalogListResponse>;
+export declare const UpdateArtifactPinRequest: z.ZodObject<{
+    pinned: z.ZodBoolean;
+}, z.core.$strict>;
+export type UpdateArtifactPinRequest = z.infer<typeof UpdateArtifactPinRequest>;
+export declare const ArtifactPinResponse: z.ZodObject<{
+    kind: z.ZodEnum<{
+        document: "document";
+        file: "file";
+        image: "image";
+        presentation: "presentation";
+        site: "site";
+        spreadsheet: "spreadsheet";
+    }>;
+    artifactId: z.ZodString;
+    pinned: z.ZodBoolean;
+}, z.core.$strict>;
+export type ArtifactPinResponse = z.infer<typeof ArtifactPinResponse>;