@opengeni/contracts 2.6.0-canary.0 → 2.7.0

package/dist/index.js

@@ -1449,6 +1449,35 @@ import {
   WORKSPACE_STATE_MAX_TOPICS,
   WORKSPACE_STATE_MEMORY_SAMPLE_LIMIT,
   WORKSPACE_STATE_TOPIC_MAX_CHARS,
+  WORK_CLAIM_ACTIVE_SESSION_CAP,
+  WORK_CLAIM_CANONICAL_KEY_MAX_BYTES,
+  WORK_CLAIM_DISCOVERY_DEFAULT_LIMIT,
+  WORK_CLAIM_DISCOVERY_LIMIT,
+  WORK_CLAIM_DISPLAY_LABEL_MAX_BYTES,
+  WORK_CLAIM_NAMESPACE_MAX_BYTES,
+  WORK_CLAIM_VERSION_VALUE_MAX_BYTES,
+  WORK_DISCOVERY_QUERY_MAX_CHARS,
+  WORK_DISCOVERY_RECENT_HOURS_MAX,
+  WorkClaim,
+  WorkClaimCanonicalKey,
+  WorkClaimDiscoverySummary,
+  WorkClaimDisplayLabel,
+  WorkClaimMutationKind,
+  WorkClaimMutationResult,
+  WorkClaimNamespace,
+  WorkClaimProvenance,
+  WorkClaimReleaseReason,
+  WorkClaimRole,
+  WorkClaimState,
+  WorkClaimSubjectFilter,
+  WorkClaimSubjectType,
+  WorkClaimVersionKind,
+  WorkClaimVersionValue,
+  WorkDiscoveryMatch,
+  WorkDiscoveryMatchClass,
+  WorkDiscoveryMatchedField,
+  WorkDiscoveryProjection,
+  WorkDiscoveryScoreBand,
   Workspace,
   WorkspaceArtifact,
   WorkspaceArtifactContentResponse,
@@ -1625,6 +1654,9 @@ import {
   normalizeRepositoryTransportUri,
   normalizeResourceMountPath,
   normalizeSessionGoalRootConstraints,
+  normalizeWorkClaimCanonicalKey,
+  normalizeWorkClaimDisplayLabel,
+  normalizeWorkClaimNamespace,
   normalizeWorkspaceArtifactSlug,
   normalizeWorkspaceInstructionPolicyRoleKey,
   normalizeWorkspaceLearningSourceKind,
@@ -1688,7 +1720,7 @@ import {
   workspaceLearningPolicyRouterContext,
   workspaceLearningSourceKey,
   workspaceSlackReactionChannelAllowed
-} from "./chunk-MJ3K6ICH.js";
+} from "./chunk-ILB4IYNN.js";
 import {
   ConnectorDocumentDestination,
   ConnectorDocumentDestinationAuthority,
@@ -3602,6 +3634,35 @@ export {
   WORKSPACE_STATE_MEMORY_SAMPLE_LIMIT,
   WORKSPACE_STATE_TOPIC_MAX_CHARS,
   WORKSPACE_XAI_PROVIDER_ACCOUNT_AUTHORITY_SNAPSHOT_V1,
+  WORK_CLAIM_ACTIVE_SESSION_CAP,
+  WORK_CLAIM_CANONICAL_KEY_MAX_BYTES,
+  WORK_CLAIM_DISCOVERY_DEFAULT_LIMIT,
+  WORK_CLAIM_DISCOVERY_LIMIT,
+  WORK_CLAIM_DISPLAY_LABEL_MAX_BYTES,
+  WORK_CLAIM_NAMESPACE_MAX_BYTES,
+  WORK_CLAIM_VERSION_VALUE_MAX_BYTES,
+  WORK_DISCOVERY_QUERY_MAX_CHARS,
+  WORK_DISCOVERY_RECENT_HOURS_MAX,
+  WorkClaim,
+  WorkClaimCanonicalKey,
+  WorkClaimDiscoverySummary,
+  WorkClaimDisplayLabel,
+  WorkClaimMutationKind,
+  WorkClaimMutationResult,
+  WorkClaimNamespace,
+  WorkClaimProvenance,
+  WorkClaimReleaseReason,
+  WorkClaimRole,
+  WorkClaimState,
+  WorkClaimSubjectFilter,
+  WorkClaimSubjectType,
+  WorkClaimVersionKind,
+  WorkClaimVersionValue,
+  WorkDiscoveryMatch,
+  WorkDiscoveryMatchClass,
+  WorkDiscoveryMatchedField,
+  WorkDiscoveryProjection,
+  WorkDiscoveryScoreBand,
   Workspace,
   WorkspaceArtifact,
   WorkspaceArtifactContentResponse,
@@ -3837,6 +3898,9 @@ export {
   normalizeRepositoryTransportUri,
   normalizeResourceMountPath,
   normalizeSessionGoalRootConstraints,
+  normalizeWorkClaimCanonicalKey,
+  normalizeWorkClaimDisplayLabel,
+  normalizeWorkClaimNamespace,
   normalizeWorkspaceArtifactSlug,
   normalizeWorkspaceInstructionPolicyRoleKey,
   normalizeWorkspaceLearningSourceKind,

package/dist/personal-github.js

@@ -1,6 +1,6 @@
 import {
   ConnectionMetadata
-} from "./chunk-MJ3K6ICH.js";
+} from "./chunk-ILB4IYNN.js";
 import "./chunk-WYBDERIY.js";
 import "./chunk-MRWYRAS5.js";
 import "./chunk-CM6BMECR.js";

package/dist/session-topology-primitives.d.ts

@@ -0,0 +1,22 @@
+import { z } from "zod";
+export declare const SessionStatus: z.ZodEnum<{
+    cancelled: "cancelled";
+    failed: "failed";
+    idle: "idle";
+    queued: "queued";
+    recovering: "recovering";
+    requires_action: "requires_action";
+    running: "running";
+    waiting_capacity: "waiting_capacity";
+}>;
+export type SessionStatus = z.infer<typeof SessionStatus>;
+export declare const SessionGoalStatus: z.ZodEnum<{
+    active: "active";
+    completed: "completed";
+    paused: "paused";
+}>;
+export type SessionGoalStatus = z.infer<typeof SessionGoalStatus>;
+/** Physical ceiling of the PostgreSQL integer columns that persist depth policy. */
+export declare const MAX_NESTED_AGENT_DEPTH = 2147483647;
+export declare const NestedAgentDepthValue: z.ZodNumber;
+export type NestedAgentDepthValue = z.infer<typeof NestedAgentDepthValue>;

package/dist/work-claims.d.ts

@@ -0,0 +1,411 @@
+import { z } from "zod";
+export declare const WORK_CLAIM_NAMESPACE_MAX_BYTES = 64;
+export declare const WORK_CLAIM_CANONICAL_KEY_MAX_BYTES = 512;
+export declare const WORK_CLAIM_DISPLAY_LABEL_MAX_BYTES = 256;
+export declare const WORK_CLAIM_VERSION_VALUE_MAX_BYTES = 256;
+export declare const WORK_CLAIM_ACTIVE_SESSION_CAP = 64;
+export declare const WORK_CLAIM_DISCOVERY_LIMIT = 8;
+export declare const WORK_CLAIM_DISCOVERY_DEFAULT_LIMIT = 4;
+export declare const WORK_DISCOVERY_QUERY_MAX_CHARS = 200;
+export declare const WORK_DISCOVERY_RECENT_HOURS_MAX: number;
+export declare function normalizeWorkClaimNamespace(value: string): string;
+export declare function normalizeWorkClaimCanonicalKey(value: string): string;
+export declare function normalizeWorkClaimDisplayLabel(value: string): string | null;
+export declare const WorkClaimNamespace: z.ZodString;
+export type WorkClaimNamespace = z.infer<typeof WorkClaimNamespace>;
+export declare const WorkClaimCanonicalKey: z.ZodString;
+export type WorkClaimCanonicalKey = z.infer<typeof WorkClaimCanonicalKey>;
+export declare const WorkClaimDisplayLabel: z.ZodString;
+export type WorkClaimDisplayLabel = z.infer<typeof WorkClaimDisplayLabel>;
+export declare const WorkClaimSubjectType: z.ZodEnum<{
+    artifact: "artifact";
+    branch: "branch";
+    ci_run: "ci_run";
+    issue: "issue";
+    other: "other";
+    pull_request: "pull_request";
+    release: "release";
+    repository: "repository";
+}>;
+export type WorkClaimSubjectType = z.infer<typeof WorkClaimSubjectType>;
+export declare const WorkClaimRole: z.ZodEnum<{
+    delivering: "delivering";
+    monitoring: "monitoring";
+    reviewing: "reviewing";
+    working: "working";
+}>;
+export type WorkClaimRole = z.infer<typeof WorkClaimRole>;
+export declare const WorkClaimState: z.ZodEnum<{
+    active: "active";
+    released: "released";
+    stale: "stale";
+    superseded: "superseded";
+}>;
+export type WorkClaimState = z.infer<typeof WorkClaimState>;
+export declare const WorkClaimProvenance: z.ZodEnum<{
+    explicit_agent: "explicit_agent";
+    session_resource: "session_resource";
+    system_lifecycle: "system_lifecycle";
+    trusted_integration: "trusted_integration";
+    user_api: "user_api";
+}>;
+export type WorkClaimProvenance = z.infer<typeof WorkClaimProvenance>;
+export declare const WorkClaimVersionKind: z.ZodEnum<{
+    artifact_version: "artifact_version";
+    branch_head: "branch_head";
+    ci_run: "ci_run";
+    git_commit: "git_commit";
+    other: "other";
+    pull_request_head: "pull_request_head";
+    release_version: "release_version";
+}>;
+export type WorkClaimVersionKind = z.infer<typeof WorkClaimVersionKind>;
+export declare const WorkClaimVersionValue: z.ZodString;
+export type WorkClaimVersionValue = z.infer<typeof WorkClaimVersionValue>;
+export declare const WorkClaimReleaseReason: z.ZodEnum<{
+    cancelled: "cancelled";
+    completed: "completed";
+    corrected: "corrected";
+    external_state_changed: "external_state_changed";
+    failed: "failed";
+    no_longer_active: "no_longer_active";
+    other: "other";
+    superseded: "superseded";
+}>;
+export type WorkClaimReleaseReason = z.infer<typeof WorkClaimReleaseReason>;
+export declare const WorkClaimMutationKind: z.ZodEnum<{
+    created: "created";
+    released: "released";
+    stale: "stale";
+    superseded: "superseded";
+    updated: "updated";
+}>;
+export type WorkClaimMutationKind = z.infer<typeof WorkClaimMutationKind>;
+export declare const WorkClaim: z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    rootSessionId: z.ZodString;
+    subject: z.ZodObject<{
+        namespace: z.ZodString;
+        type: z.ZodEnum<{
+            artifact: "artifact";
+            branch: "branch";
+            ci_run: "ci_run";
+            issue: "issue";
+            other: "other";
+            pull_request: "pull_request";
+            release: "release";
+            repository: "repository";
+        }>;
+        canonicalKey: z.ZodString;
+        displayLabel: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    role: z.ZodEnum<{
+        delivering: "delivering";
+        monitoring: "monitoring";
+        reviewing: "reviewing";
+        working: "working";
+    }>;
+    state: z.ZodEnum<{
+        active: "active";
+        released: "released";
+        stale: "stale";
+        superseded: "superseded";
+    }>;
+    revision: z.ZodNumber;
+    provenance: z.ZodEnum<{
+        explicit_agent: "explicit_agent";
+        session_resource: "session_resource";
+        system_lifecycle: "system_lifecycle";
+        trusted_integration: "trusted_integration";
+        user_api: "user_api";
+    }>;
+    version: z.ZodNullable<z.ZodObject<{
+        kind: z.ZodEnum<{
+            artifact_version: "artifact_version";
+            branch_head: "branch_head";
+            ci_run: "ci_run";
+            git_commit: "git_commit";
+            other: "other";
+            pull_request_head: "pull_request_head";
+            release_version: "release_version";
+        }>;
+        value: z.ZodString;
+    }, z.core.$strip>>;
+    observedAt: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    settledAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type WorkClaim = z.infer<typeof WorkClaim>;
+export declare const WorkClaimMutationResult: z.ZodObject<{
+    claim: z.ZodObject<{
+        id: z.ZodString;
+        sessionId: z.ZodString;
+        rootSessionId: z.ZodString;
+        subject: z.ZodObject<{
+            namespace: z.ZodString;
+            type: z.ZodEnum<{
+                artifact: "artifact";
+                branch: "branch";
+                ci_run: "ci_run";
+                issue: "issue";
+                other: "other";
+                pull_request: "pull_request";
+                release: "release";
+                repository: "repository";
+            }>;
+            canonicalKey: z.ZodString;
+            displayLabel: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        role: z.ZodEnum<{
+            delivering: "delivering";
+            monitoring: "monitoring";
+            reviewing: "reviewing";
+            working: "working";
+        }>;
+        state: z.ZodEnum<{
+            active: "active";
+            released: "released";
+            stale: "stale";
+            superseded: "superseded";
+        }>;
+        revision: z.ZodNumber;
+        provenance: z.ZodEnum<{
+            explicit_agent: "explicit_agent";
+            session_resource: "session_resource";
+            system_lifecycle: "system_lifecycle";
+            trusted_integration: "trusted_integration";
+            user_api: "user_api";
+        }>;
+        version: z.ZodNullable<z.ZodObject<{
+            kind: z.ZodEnum<{
+                artifact_version: "artifact_version";
+                branch_head: "branch_head";
+                ci_run: "ci_run";
+                git_commit: "git_commit";
+                other: "other";
+                pull_request_head: "pull_request_head";
+                release_version: "release_version";
+            }>;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        observedAt: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        settledAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    mutation: z.ZodEnum<{
+        created: "created";
+        released: "released";
+        stale: "stale";
+        superseded: "superseded";
+        updated: "updated";
+    }>;
+    replayed: z.ZodBoolean;
+}, z.core.$strip>;
+export type WorkClaimMutationResult = z.infer<typeof WorkClaimMutationResult>;
+export declare const WorkClaimDiscoverySummary: z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    subject: z.ZodObject<{
+        namespace: z.ZodString;
+        type: z.ZodEnum<{
+            artifact: "artifact";
+            branch: "branch";
+            ci_run: "ci_run";
+            issue: "issue";
+            other: "other";
+            pull_request: "pull_request";
+            release: "release";
+            repository: "repository";
+        }>;
+        canonicalKey: z.ZodString;
+        displayLabel: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+    role: z.ZodEnum<{
+        delivering: "delivering";
+        monitoring: "monitoring";
+        reviewing: "reviewing";
+        working: "working";
+    }>;
+    state: z.ZodEnum<{
+        active: "active";
+        released: "released";
+        stale: "stale";
+        superseded: "superseded";
+    }>;
+    revision: z.ZodNumber;
+    provenance: z.ZodEnum<{
+        explicit_agent: "explicit_agent";
+        session_resource: "session_resource";
+        system_lifecycle: "system_lifecycle";
+        trusted_integration: "trusted_integration";
+        user_api: "user_api";
+    }>;
+    version: z.ZodNullable<z.ZodObject<{
+        kind: z.ZodEnum<{
+            artifact_version: "artifact_version";
+            branch_head: "branch_head";
+            ci_run: "ci_run";
+            git_commit: "git_commit";
+            other: "other";
+            pull_request_head: "pull_request_head";
+            release_version: "release_version";
+        }>;
+        value: z.ZodString;
+    }, z.core.$strip>>;
+    observedAt: z.ZodString;
+    updatedAt: z.ZodString;
+    settledAt: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type WorkClaimDiscoverySummary = z.infer<typeof WorkClaimDiscoverySummary>;
+export declare const WorkClaimSubjectFilter: z.ZodObject<{
+    namespace: z.ZodString;
+    type: z.ZodEnum<{
+        artifact: "artifact";
+        branch: "branch";
+        ci_run: "ci_run";
+        issue: "issue";
+        other: "other";
+        pull_request: "pull_request";
+        release: "release";
+        repository: "repository";
+    }>;
+    canonicalKey: z.ZodString;
+}, z.core.$strict>;
+export type WorkClaimSubjectFilter = z.infer<typeof WorkClaimSubjectFilter>;
+export declare const WorkDiscoveryMatchClass: z.ZodEnum<{
+    exact_subject: "exact_subject";
+    fuzzy: "fuzzy";
+    goal: "goal";
+    title: "title";
+}>;
+export type WorkDiscoveryMatchClass = z.infer<typeof WorkDiscoveryMatchClass>;
+export declare const WorkDiscoveryMatchedField: z.ZodEnum<{
+    claim_key: "claim_key";
+    claim_label: "claim_label";
+    goal: "goal";
+    subject: "subject";
+    title: "title";
+}>;
+export type WorkDiscoveryMatchedField = z.infer<typeof WorkDiscoveryMatchedField>;
+/**
+ * Deliberately stable bands rather than a raw ranking score. Raw full-text or
+ * trigram values are query-relative and become a misleading cross-query API.
+ */
+export declare const WorkDiscoveryScoreBand: z.ZodEnum<{
+    exact: "exact";
+    related: "related";
+    strong: "strong";
+}>;
+export type WorkDiscoveryScoreBand = z.infer<typeof WorkDiscoveryScoreBand>;
+export declare const WorkDiscoveryMatch: z.ZodObject<{
+    class: z.ZodEnum<{
+        exact_subject: "exact_subject";
+        fuzzy: "fuzzy";
+        goal: "goal";
+        title: "title";
+    }>;
+    field: z.ZodEnum<{
+        claim_key: "claim_key";
+        claim_label: "claim_label";
+        goal: "goal";
+        subject: "subject";
+        title: "title";
+    }>;
+    scoreBand: z.ZodEnum<{
+        exact: "exact";
+        related: "related";
+        strong: "strong";
+    }>;
+    claimId: z.ZodNullable<z.ZodString>;
+}, z.core.$strict>;
+export type WorkDiscoveryMatch = z.infer<typeof WorkDiscoveryMatch>;
+/**
+ * Provider-neutral related-work evidence. The two literal booleans are part of
+ * the wire contract so a consumer cannot accidentally present a claim as a
+ * lock, authorization grant, ownership transfer, or mandatory instruction.
+ */
+export declare const WorkDiscoveryProjection: z.ZodObject<{
+    claims: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        sessionId: z.ZodString;
+        subject: z.ZodObject<{
+            namespace: z.ZodString;
+            type: z.ZodEnum<{
+                artifact: "artifact";
+                branch: "branch";
+                ci_run: "ci_run";
+                issue: "issue";
+                other: "other";
+                pull_request: "pull_request";
+                release: "release";
+                repository: "repository";
+            }>;
+            canonicalKey: z.ZodString;
+            displayLabel: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>;
+        role: z.ZodEnum<{
+            delivering: "delivering";
+            monitoring: "monitoring";
+            reviewing: "reviewing";
+            working: "working";
+        }>;
+        state: z.ZodEnum<{
+            active: "active";
+            released: "released";
+            stale: "stale";
+            superseded: "superseded";
+        }>;
+        revision: z.ZodNumber;
+        provenance: z.ZodEnum<{
+            explicit_agent: "explicit_agent";
+            session_resource: "session_resource";
+            system_lifecycle: "system_lifecycle";
+            trusted_integration: "trusted_integration";
+            user_api: "user_api";
+        }>;
+        version: z.ZodNullable<z.ZodObject<{
+            kind: z.ZodEnum<{
+                artifact_version: "artifact_version";
+                branch_head: "branch_head";
+                ci_run: "ci_run";
+                git_commit: "git_commit";
+                other: "other";
+                pull_request_head: "pull_request_head";
+                release_version: "release_version";
+            }>;
+            value: z.ZodString;
+        }, z.core.$strip>>;
+        observedAt: z.ZodString;
+        updatedAt: z.ZodString;
+        settledAt: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    claimsTruncated: z.ZodBoolean;
+    match: z.ZodNullable<z.ZodObject<{
+        class: z.ZodEnum<{
+            exact_subject: "exact_subject";
+            fuzzy: "fuzzy";
+            goal: "goal";
+            title: "title";
+        }>;
+        field: z.ZodEnum<{
+            claim_key: "claim_key";
+            claim_label: "claim_label";
+            goal: "goal";
+            subject: "subject";
+            title: "title";
+        }>;
+        scoreBand: z.ZodEnum<{
+            exact: "exact";
+            related: "related";
+            strong: "strong";
+        }>;
+        claimId: z.ZodNullable<z.ZodString>;
+    }, z.core.$strict>>;
+    possibleOverlap: z.ZodBoolean;
+    advisoryOnly: z.ZodLiteral<true>;
+    noAdditionalAccess: z.ZodLiteral<true>;
+}, z.core.$strict>;
+export type WorkDiscoveryProjection = z.infer<typeof WorkDiscoveryProjection>;

package/package.json

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

package/src/agent-topology.ts

@@ -0,0 +1,69 @@
+import { z } from "zod";
+
+import {
+  NestedAgentDepthValue,
+  SessionGoalStatus,
+  SessionStatus,
+} from "./session-topology-primitives";
+import { WorkDiscoveryProjection } from "./work-claims";
+
+/** Compact, bounded session projection for workspace agent-topology browsers. */
+export const AgentTopologySession = z.object({
+  id: z.string().uuid(),
+  title: z.string().nullable(),
+  titleTruncated: z.boolean(),
+  parentSessionId: z.string().uuid().nullable(),
+  rootSessionId: z.string().uuid(),
+  nestedAgentDepth: NestedAgentDepthValue,
+  ancestorPath: z.array(
+    z.object({
+      id: z.string().uuid(),
+      title: z.string().nullable(),
+      titleTruncated: z.boolean(),
+    }),
+  ),
+  status: SessionStatus,
+  goal: z
+    .object({
+      status: SessionGoalStatus,
+      summary: z.string(),
+      summaryTruncated: z.boolean(),
+    })
+    .nullable(),
+  pause: z.object({
+    state: z.enum(["active", "paused"]),
+    additionalBlockerCount: z.number().int().nonnegative(),
+    source: z
+      .object({
+        kind: z.enum(["session", "workspace"]),
+        sessionId: z.string().uuid().optional(),
+        displayName: z.string(),
+        displayNameTruncated: z.boolean(),
+      })
+      .nullable(),
+  }),
+  children: z.object({
+    directChildren: z.number().int().nonnegative(),
+    totalDescendants: z.number().int().nonnegative(),
+    runningDescendants: z.number().int().nonnegative(),
+    queuedDescendants: z.number().int().nonnegative(),
+    attentionDescendants: z.number().int().nonnegative(),
+    pausedDescendants: z.number().int().nonnegative(),
+    failedDescendants: z.number().int().nonnegative(),
+    truncated: z.boolean(),
+  }),
+  relatedWork: WorkDiscoveryProjection,
+  createdAt: z.string(),
+  updatedAt: z.string(),
+});
+export type AgentTopologySession = z.infer<typeof AgentTopologySession>;
+
+export const AgentTopologyPageResponse = z.object({
+  sessions: z.array(AgentTopologySession),
+  total: z.number().int().nonnegative(),
+  hasMore: z.boolean(),
+  /** Operator rollout decision for human advisory presentation. */
+  humanAdvisoriesEnabled: z.boolean().optional(),
+  nextCursor: z.string().nullable(),
+});
+export type AgentTopologyPageResponse = z.infer<typeof AgentTopologyPageResponse>;