@granular-software/sdk 0.4.49 → 0.4.51

package/dist/{client-B-MPVvDr.d.mts → client-NSH-tpNU.d.ts}

@@ -1,4 +1,4 @@
-import { bl as WSClientOptions, a7 as GranularQuotaProgress, T as ToolWithHandler, f as PublishToolsResult, aT as Job, g as ToolHandler, I as InstanceToolHandler, aV as ConversationMessageInput, aW as ConversationAppendResult, aG as EffectInfo, P as Prompt, aF as ToolInfo, aI as EffectsChangedEvent, aH as ToolsChangedEvent, D as DomainState, Q as GranularOptions, bM as EnvironmentImporter, W as RecordUserOptions, V as User, Y as OpenEnvironmentOptions, ak as EnvironmentData, ah as BuildPolicy, bK as EnvironmentSetupSummary, $ as ConversationSessionInfo, _ as CreateSessionOptions, bv as RecordObjectOptions, bw as RecordObjectResult, by as RecordObjectsOptions, bF as RecordImport, bB as RecordImportStatus, bG as EnvironmentRecordImportSummary, aR as EnvironmentFeedbackRecord, c as SessionHeapSnapshot, b9 as SessionDocumentResult, ba as SessionCollectionListOptions, bc as SessionCollectionListResult, aX as SessionConversationMessage, aY as SessionTimelineEvent, bb as SessionJobListOptions, b2 as SessionJobRecord, b0 as SessionFileRecord, b1 as SessionFileUploadOptions, S as SessionHeapEntry, b as SessionHeapList, b5 as SessionHeapVariable, d as SessionTranscriptEntry, c6 as GraphQLResult, b7 as RecordSearchOptions, b6 as RecordSearchResult, b8 as RecordMentionInput, bu as DefineRelationshipOptions, bt as RelationshipInfo, bs as ModelRef, c5 as ManifestContent, bA as RecordImportOptions, bh as UserEnvironmentStateOptions, bg as UserEnvironmentState, bi as MarkUserEnvironmentReadOptions, Z as ConnectOptions, bI as RunEnvironmentImporterOptions, l as OpenAIUsageSpendEvent, G as GranularSpendContext, o as RecordOpenAIUsageSpendResult, aa as SandboxListResponse, a8 as Sandbox, a9 as CreateSandboxData, c8 as DeleteResponse, ac as PermissionProfile, ad as CreatePermissionProfileData, al as CreateEnvironmentData, c9 as StreamEvent, ca as StreamSubscription, cb as StreamStats, X as Subject, ag as AssignmentListResponse } from './spend-CStuOBXb.mjs';
+import { bL as WSClientOptions, a1 as GranularQuotaProgress, T as ToolWithHandler, f as PublishToolsResult, aN as Job, g as ToolHandler, I as InstanceToolHandler, aX as ConversationMessageInput, aY as ConversationAppendResult, aA as EffectInfo, P as Prompt, az as ToolInfo, aC as EffectsChangedEvent, aB as ToolsChangedEvent, D as DomainState, y as GranularOptions, cg as EnvironmentImporter, B as RecordUserOptions, U as User, H as OpenEnvironmentOptions, ae as EnvironmentData, ab as BuildPolicy, ce as EnvironmentSetupSummary, V as ConversationSessionListOptions, L as ConversationSessionInfo, K as CreateSessionOptions, bV as RecordObjectOptions, c0 as RecordObjectResult, c2 as RecordObjectsOptions, c9 as RecordImport, c5 as RecordImportStatus, ca as EnvironmentRecordImportSummary, aL as EnvironmentFeedbackRecord, c as SessionHeapSnapshot, bz as SessionDocumentResult, bA as SessionCollectionListOptions, bC as SessionCollectionListResult, aZ as SessionConversationMessage, a_ as SessionTimelineEvent, bB as SessionJobListOptions, bs as SessionJobRecord, b7 as SessionArtifactListOptions, b6 as SessionArtifactRecord, b8 as SessionArtifactValidationResult, ba as SessionArtifactExecutionOptions, b9 as SessionArtifactExecutionResult, bb as SessionArtifactApprovalOptions, bl as RecordManualActionInput, bn as ManualActionRecordResult, bo as ManualActionListOptions, bm as ManualActionOccurrence, bq as ManualActionSuggestionOptions, bp as ManualActionSuggestion, be as ArtifactApprovalTaskListOptions, bd as ArtifactApprovalTask, bf as ArtifactApprovalDecisionInput, bg as ArtifactApprovalDecisionResult, b2 as SessionFileRecord, br as SessionFileUploadOptions, S as SessionHeapEntry, b as SessionHeapList, bv as SessionHeapVariable, d as SessionTranscriptEntry, cK as GraphQLResult, bx as RecordSearchOptions, bw as RecordSearchResult, by as RecordMentionInput, bU as DefineRelationshipOptions, bT as RelationshipInfo, bS as ModelRef, cJ as ManifestContent, bZ as EnvironmentStateUpdateInput, bX as EnvironmentStateTarget, b$ as EnvironmentStateProxy, c4 as RecordImportOptions, bH as UserEnvironmentStateOptions, bG as UserEnvironmentState, bI as MarkUserEnvironmentReadOptions, J as ConnectOptions, cc as RunEnvironmentImporterOptions, l as OpenAIUsageSpendEvent, G as GranularSpendContext, o as RecordOpenAIUsageSpendResult, a4 as SandboxListResponse, a2 as Sandbox, a3 as CreateSandboxData, cM as DeleteResponse, a6 as PermissionProfile, a7 as CreatePermissionProfileData, af as CreateEnvironmentData, cN as StreamEvent, cO as StreamSubscription, cP as StreamStats, F as Subject, aa as AssignmentListResponse } from './spend-BA-jZwZ0.js';
 import * as Automerge from '@automerge/automerge';
 import { Doc } from '@automerge/automerge/slim';
 
@@ -18,9 +18,14 @@ declare class WSClient {
     private tokenRefreshTimer;
     private isExplicitlyDisconnected;
     private reconnectAttempts;
+    private connectPromise;
+    private connectionEpoch;
+    private cancelConnectAttempt;
     private options;
     constructor(options: WSClientOptions);
     get currentSessionId(): string;
+    seedDocumentSnapshot(document: Record<string, unknown> | Uint8Array | null | undefined): void;
+    saveDocumentSnapshot(): Uint8Array;
     private clearTokenRefreshTimer;
     private decodeBase64Url;
     private getTokenExpiryMs;
@@ -31,9 +36,14 @@ declare class WSClient {
      * Connect to the WebSocket server
      * @returns {Promise<void>} Resolves when connection is open
      */
-    connect(): Promise<void>;
+    connect(options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    private connectAttempt;
     private normalizeReason;
     private rejectPending;
+    private emitReconnectErrorMessage;
+    private scheduleReconnectAttempt;
     private buildDisconnectError;
     private handleDisconnect;
     private handleMessage;
@@ -73,7 +83,9 @@ declare class WSClient {
     /**
      * Disconnect the WebSocket and clear state
      */
-    disconnect(): void;
+    disconnect(options?: {
+        reason?: string;
+    }): void;
 }
 
 declare class Session {
@@ -308,9 +320,7 @@ declare class Environment {
     get runtimeBaseUrl(): string;
     syncEnvironmentData(envData: EnvironmentData): void;
     get sessions(): {
-        list: (options?: {
-            status?: "active" | "closed" | "all";
-        }) => Promise<ConversationSessionInfo[]>;
+        list: (options?: Omit<ConversationSessionListOptions, "environmentId" | "sandboxId" | "subjectId">) => Promise<ConversationSessionInfo[]>;
         create: (options?: CreateSessionOptions) => Promise<EnvironmentSession>;
         connect: (sessionId: string, options?: {
             clientId?: string;
@@ -338,9 +348,33 @@ declare class Environment {
         cancelImport: (importId: string) => Promise<RecordImport>;
         getAwaitingCount: () => Promise<number>;
     };
+    /**
+     * Mirror product-owned workflow state into Granular without making Granular
+     * own the customer application's state machine.
+     */
+    recordState(input: EnvironmentStateUpdateInput): Promise<RecordObjectResult>;
+    /**
+     * Mirror product-owned workflow state into Granular without making Granular
+     * own the customer application's state machine.
+     *
+     * Example:
+     * `await env.recordState({ className: "spend_request", id, machine: "lifecycle", state: "policy_review", source: "customer_backend" })`
+     */
+    state(target: EnvironmentStateTarget): EnvironmentStateProxy;
     get feedback(): {
         list: () => Promise<EnvironmentFeedbackRecord[]>;
     };
+    get manualActions(): {
+        record: (input: RecordManualActionInput) => Promise<ManualActionRecordResult>;
+        list: (options?: ManualActionListOptions) => Promise<SessionCollectionListResult<ManualActionOccurrence>>;
+        suggest: (options?: ManualActionSuggestionOptions) => Promise<{
+            items: ManualActionSuggestion[];
+        }>;
+    };
+    get artifactApprovals(): {
+        list: (options?: ArtifactApprovalTaskListOptions) => Promise<SessionCollectionListResult<ArtifactApprovalTask>>;
+        decide: (approvalTaskId: string, input: ArtifactApprovalDecisionInput) => Promise<ArtifactApprovalDecisionResult>;
+    };
     /**
      * Sessionless environments do not own a live transport, so disconnecting the
      * environment handle itself is a no-op. This keeps the public surface
@@ -349,7 +383,8 @@ declare class Environment {
      * or a session.
      */
     disconnect(): Promise<void>;
-    listSessions(status?: "active" | "closed" | "all"): Promise<ConversationSessionInfo[]>;
+    listSessions(status?: ConversationSessionListOptions["status"]): Promise<ConversationSessionInfo[]>;
+    listSessions(options?: Omit<ConversationSessionListOptions, "environmentId" | "sandboxId" | "subjectId">): Promise<ConversationSessionInfo[]>;
     getUserEnvironmentState(options?: UserEnvironmentStateOptions): Promise<UserEnvironmentState>;
     markUserEnvironmentSessionsRead(options: MarkUserEnvironmentReadOptions): Promise<UserEnvironmentState["readAtBySessionId"]>;
     createSession(options?: CreateSessionOptions): Promise<EnvironmentSession>;
@@ -363,6 +398,13 @@ declare class Environment {
     }): Promise<EnvironmentSession>;
     closeSession(sessionId: string, session?: EnvironmentSession | null): Promise<void>;
     listFeedback(): Promise<EnvironmentFeedbackRecord[]>;
+    recordManualAction(input: RecordManualActionInput): Promise<ManualActionRecordResult>;
+    listManualActions(options?: ManualActionListOptions): Promise<SessionCollectionListResult<ManualActionOccurrence>>;
+    suggestManualActions(options?: ManualActionSuggestionOptions): Promise<{
+        items: ManualActionSuggestion[];
+    }>;
+    listArtifactApprovals(options?: ArtifactApprovalTaskListOptions): Promise<SessionCollectionListResult<ArtifactApprovalTask>>;
+    decideArtifactApproval(approvalTaskId: string, input: ArtifactApprovalDecisionInput): Promise<ArtifactApprovalDecisionResult>;
     private getRuntimeBaseUrl;
     private controlPlaneRequest;
     private static normalizeGraphPathSegment;
@@ -707,6 +749,35 @@ declare class EnvironmentSession extends Session {
     get jobs(): {
         list: (options?: SessionJobListOptions) => Promise<SessionCollectionListResult<SessionJobRecord>>;
         get: (jobId: string) => Promise<SessionJobRecord>;
+        latest: (options?: Pick<SessionJobListOptions, "status">) => Promise<SessionJobRecord | null>;
+    };
+    get artifacts(): {
+        list: (options?: SessionArtifactListOptions) => Promise<SessionCollectionListResult<SessionArtifactRecord>>;
+        listForLatestJob: (options?: Omit<SessionArtifactListOptions, "jobId" | "latestJob">) => Promise<SessionCollectionListResult<SessionArtifactRecord>>;
+        get: (artifactId: string) => Promise<SessionArtifactRecord>;
+        create: (artifact: Partial<SessionArtifactRecord> & {
+            label: string;
+        }) => Promise<SessionArtifactRecord>;
+        updateInputs: (artifactId: string, patch: {
+            inputValues?: Record<string, unknown>;
+            relationships?: Record<string, string | string[] | null>;
+            expectedUpdatedAt?: number;
+        }) => Promise<SessionArtifactRecord>;
+        validate: (artifactId: string) => Promise<SessionArtifactValidationResult>;
+        execute: (artifactId: string, options: SessionArtifactExecutionOptions) => Promise<SessionArtifactExecutionResult>;
+        approve: (artifactId: string, options: SessionArtifactApprovalOptions) => Promise<SessionArtifactExecutionResult>;
+        cancel: (artifactId: string) => Promise<SessionArtifactRecord>;
+    };
+    get manualActions(): {
+        record: (input: RecordManualActionInput) => Promise<ManualActionRecordResult>;
+        list: (options?: ManualActionListOptions) => Promise<SessionCollectionListResult<ManualActionOccurrence>>;
+        suggest: (options?: ManualActionSuggestionOptions) => Promise<{
+            items: ManualActionSuggestion[];
+        }>;
+    };
+    get artifactApprovals(): {
+        list: (options?: ArtifactApprovalTaskListOptions) => Promise<SessionCollectionListResult<ArtifactApprovalTask>>;
+        decide: (approvalTaskId: string, input: ArtifactApprovalDecisionInput) => Promise<ArtifactApprovalDecisionResult>;
     };
     get files(): {
         list: (options?: SessionCollectionListOptions & {
@@ -755,6 +826,8 @@ declare class EnvironmentSession extends Session {
         errors: string[];
     }>;
     recordObject(options: RecordObjectOptions): Promise<RecordObjectResult>;
+    recordState(input: EnvironmentStateUpdateInput): Promise<RecordObjectResult>;
+    state(target: EnvironmentStateTarget): EnvironmentStateProxy;
     recordObjects(records: RecordObjectOptions[], options?: RecordObjectsOptions): Promise<RecordObjectResult[]>;
     enqueueRecordImport(records: RecordObjectOptions[], options?: RecordImportOptions): Promise<RecordImport>;
     listRecordImports(status?: RecordImportStatus): Promise<RecordImport[]>;
@@ -903,15 +976,19 @@ declare class Granular {
     private sortEnvironmentsByRecency;
     private resolveOpenEnvironmentData;
     /**
-     * List active (open) sessions for an environment — each session is one agent conversation thread.
+     * List indexed sessions using ownership filters and bounded pagination.
+     */
+    listSessions(options: ConversationSessionListOptions): Promise<ConversationSessionInfo[]>;
+    /**
+     * List active (open) sessions for an environment.
      */
-    listOpenSessions(filters: {
+    listOpenSessions(filters: Omit<ConversationSessionListOptions, "status"> & {
         environmentId: string;
     }): Promise<ConversationSessionInfo[]>;
     /**
      * List closed sessions for an environment (conversations that have disconnected).
      */
-    listClosedSessions(filters: {
+    listClosedSessions(filters: Omit<ConversationSessionListOptions, "status"> & {
         environmentId: string;
     }): Promise<ConversationSessionInfo[]>;
     getUserEnvironmentState(options: UserEnvironmentStateOptions & {
@@ -920,7 +997,6 @@ declare class Granular {
     markUserEnvironmentSessionsRead(options: MarkUserEnvironmentReadOptions & {
         environmentId: string;
     }): Promise<UserEnvironmentState["readAtBySessionId"]>;
-    private listSessionsForEnvironment;
     private normalizeConversationSession;
     private normalizeUserEnvironmentState;
     private static coerceIsoDate;
@@ -931,6 +1007,7 @@ declare class Granular {
     createSession(options: {
         environmentId: string;
         clientId?: string;
+        sessionScope?: CreateSessionOptions["sessionScope"];
         initialHeap?: CreateSessionOptions["initialHeap"];
     }): Promise<EnvironmentSession>;
     /**

package/dist/{client-zihxkDDs.d.ts → client-djorlOpn.d.mts}

@@ -1,4 +1,4 @@
-import { bl as WSClientOptions, a7 as GranularQuotaProgress, T as ToolWithHandler, f as PublishToolsResult, aT as Job, g as ToolHandler, I as InstanceToolHandler, aV as ConversationMessageInput, aW as ConversationAppendResult, aG as EffectInfo, P as Prompt, aF as ToolInfo, aI as EffectsChangedEvent, aH as ToolsChangedEvent, D as DomainState, Q as GranularOptions, bM as EnvironmentImporter, W as RecordUserOptions, V as User, Y as OpenEnvironmentOptions, ak as EnvironmentData, ah as BuildPolicy, bK as EnvironmentSetupSummary, $ as ConversationSessionInfo, _ as CreateSessionOptions, bv as RecordObjectOptions, bw as RecordObjectResult, by as RecordObjectsOptions, bF as RecordImport, bB as RecordImportStatus, bG as EnvironmentRecordImportSummary, aR as EnvironmentFeedbackRecord, c as SessionHeapSnapshot, b9 as SessionDocumentResult, ba as SessionCollectionListOptions, bc as SessionCollectionListResult, aX as SessionConversationMessage, aY as SessionTimelineEvent, bb as SessionJobListOptions, b2 as SessionJobRecord, b0 as SessionFileRecord, b1 as SessionFileUploadOptions, S as SessionHeapEntry, b as SessionHeapList, b5 as SessionHeapVariable, d as SessionTranscriptEntry, c6 as GraphQLResult, b7 as RecordSearchOptions, b6 as RecordSearchResult, b8 as RecordMentionInput, bu as DefineRelationshipOptions, bt as RelationshipInfo, bs as ModelRef, c5 as ManifestContent, bA as RecordImportOptions, bh as UserEnvironmentStateOptions, bg as UserEnvironmentState, bi as MarkUserEnvironmentReadOptions, Z as ConnectOptions, bI as RunEnvironmentImporterOptions, l as OpenAIUsageSpendEvent, G as GranularSpendContext, o as RecordOpenAIUsageSpendResult, aa as SandboxListResponse, a8 as Sandbox, a9 as CreateSandboxData, c8 as DeleteResponse, ac as PermissionProfile, ad as CreatePermissionProfileData, al as CreateEnvironmentData, c9 as StreamEvent, ca as StreamSubscription, cb as StreamStats, X as Subject, ag as AssignmentListResponse } from './spend-CStuOBXb.js';
+import { bL as WSClientOptions, a1 as GranularQuotaProgress, T as ToolWithHandler, f as PublishToolsResult, aN as Job, g as ToolHandler, I as InstanceToolHandler, aX as ConversationMessageInput, aY as ConversationAppendResult, aA as EffectInfo, P as Prompt, az as ToolInfo, aC as EffectsChangedEvent, aB as ToolsChangedEvent, D as DomainState, y as GranularOptions, cg as EnvironmentImporter, B as RecordUserOptions, U as User, H as OpenEnvironmentOptions, ae as EnvironmentData, ab as BuildPolicy, ce as EnvironmentSetupSummary, V as ConversationSessionListOptions, L as ConversationSessionInfo, K as CreateSessionOptions, bV as RecordObjectOptions, c0 as RecordObjectResult, c2 as RecordObjectsOptions, c9 as RecordImport, c5 as RecordImportStatus, ca as EnvironmentRecordImportSummary, aL as EnvironmentFeedbackRecord, c as SessionHeapSnapshot, bz as SessionDocumentResult, bA as SessionCollectionListOptions, bC as SessionCollectionListResult, aZ as SessionConversationMessage, a_ as SessionTimelineEvent, bB as SessionJobListOptions, bs as SessionJobRecord, b7 as SessionArtifactListOptions, b6 as SessionArtifactRecord, b8 as SessionArtifactValidationResult, ba as SessionArtifactExecutionOptions, b9 as SessionArtifactExecutionResult, bb as SessionArtifactApprovalOptions, bl as RecordManualActionInput, bn as ManualActionRecordResult, bo as ManualActionListOptions, bm as ManualActionOccurrence, bq as ManualActionSuggestionOptions, bp as ManualActionSuggestion, be as ArtifactApprovalTaskListOptions, bd as ArtifactApprovalTask, bf as ArtifactApprovalDecisionInput, bg as ArtifactApprovalDecisionResult, b2 as SessionFileRecord, br as SessionFileUploadOptions, S as SessionHeapEntry, b as SessionHeapList, bv as SessionHeapVariable, d as SessionTranscriptEntry, cK as GraphQLResult, bx as RecordSearchOptions, bw as RecordSearchResult, by as RecordMentionInput, bU as DefineRelationshipOptions, bT as RelationshipInfo, bS as ModelRef, cJ as ManifestContent, bZ as EnvironmentStateUpdateInput, bX as EnvironmentStateTarget, b$ as EnvironmentStateProxy, c4 as RecordImportOptions, bH as UserEnvironmentStateOptions, bG as UserEnvironmentState, bI as MarkUserEnvironmentReadOptions, J as ConnectOptions, cc as RunEnvironmentImporterOptions, l as OpenAIUsageSpendEvent, G as GranularSpendContext, o as RecordOpenAIUsageSpendResult, a4 as SandboxListResponse, a2 as Sandbox, a3 as CreateSandboxData, cM as DeleteResponse, a6 as PermissionProfile, a7 as CreatePermissionProfileData, af as CreateEnvironmentData, cN as StreamEvent, cO as StreamSubscription, cP as StreamStats, F as Subject, aa as AssignmentListResponse } from './spend-BA-jZwZ0.mjs';
 import * as Automerge from '@automerge/automerge';
 import { Doc } from '@automerge/automerge/slim';
 
@@ -18,9 +18,14 @@ declare class WSClient {
     private tokenRefreshTimer;
     private isExplicitlyDisconnected;
     private reconnectAttempts;
+    private connectPromise;
+    private connectionEpoch;
+    private cancelConnectAttempt;
     private options;
     constructor(options: WSClientOptions);
     get currentSessionId(): string;
+    seedDocumentSnapshot(document: Record<string, unknown> | Uint8Array | null | undefined): void;
+    saveDocumentSnapshot(): Uint8Array;
     private clearTokenRefreshTimer;
     private decodeBase64Url;
     private getTokenExpiryMs;
@@ -31,9 +36,14 @@ declare class WSClient {
      * Connect to the WebSocket server
      * @returns {Promise<void>} Resolves when connection is open
      */
-    connect(): Promise<void>;
+    connect(options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    private connectAttempt;
     private normalizeReason;
     private rejectPending;
+    private emitReconnectErrorMessage;
+    private scheduleReconnectAttempt;
     private buildDisconnectError;
     private handleDisconnect;
     private handleMessage;
@@ -73,7 +83,9 @@ declare class WSClient {
     /**
      * Disconnect the WebSocket and clear state
      */
-    disconnect(): void;
+    disconnect(options?: {
+        reason?: string;
+    }): void;
 }
 
 declare class Session {
@@ -308,9 +320,7 @@ declare class Environment {
     get runtimeBaseUrl(): string;
     syncEnvironmentData(envData: EnvironmentData): void;
     get sessions(): {
-        list: (options?: {
-            status?: "active" | "closed" | "all";
-        }) => Promise<ConversationSessionInfo[]>;
+        list: (options?: Omit<ConversationSessionListOptions, "environmentId" | "sandboxId" | "subjectId">) => Promise<ConversationSessionInfo[]>;
         create: (options?: CreateSessionOptions) => Promise<EnvironmentSession>;
         connect: (sessionId: string, options?: {
             clientId?: string;
@@ -338,9 +348,33 @@ declare class Environment {
         cancelImport: (importId: string) => Promise<RecordImport>;
         getAwaitingCount: () => Promise<number>;
     };
+    /**
+     * Mirror product-owned workflow state into Granular without making Granular
+     * own the customer application's state machine.
+     */
+    recordState(input: EnvironmentStateUpdateInput): Promise<RecordObjectResult>;
+    /**
+     * Mirror product-owned workflow state into Granular without making Granular
+     * own the customer application's state machine.
+     *
+     * Example:
+     * `await env.recordState({ className: "spend_request", id, machine: "lifecycle", state: "policy_review", source: "customer_backend" })`
+     */
+    state(target: EnvironmentStateTarget): EnvironmentStateProxy;
     get feedback(): {
         list: () => Promise<EnvironmentFeedbackRecord[]>;
     };
+    get manualActions(): {
+        record: (input: RecordManualActionInput) => Promise<ManualActionRecordResult>;
+        list: (options?: ManualActionListOptions) => Promise<SessionCollectionListResult<ManualActionOccurrence>>;
+        suggest: (options?: ManualActionSuggestionOptions) => Promise<{
+            items: ManualActionSuggestion[];
+        }>;
+    };
+    get artifactApprovals(): {
+        list: (options?: ArtifactApprovalTaskListOptions) => Promise<SessionCollectionListResult<ArtifactApprovalTask>>;
+        decide: (approvalTaskId: string, input: ArtifactApprovalDecisionInput) => Promise<ArtifactApprovalDecisionResult>;
+    };
     /**
      * Sessionless environments do not own a live transport, so disconnecting the
      * environment handle itself is a no-op. This keeps the public surface
@@ -349,7 +383,8 @@ declare class Environment {
      * or a session.
      */
     disconnect(): Promise<void>;
-    listSessions(status?: "active" | "closed" | "all"): Promise<ConversationSessionInfo[]>;
+    listSessions(status?: ConversationSessionListOptions["status"]): Promise<ConversationSessionInfo[]>;
+    listSessions(options?: Omit<ConversationSessionListOptions, "environmentId" | "sandboxId" | "subjectId">): Promise<ConversationSessionInfo[]>;
     getUserEnvironmentState(options?: UserEnvironmentStateOptions): Promise<UserEnvironmentState>;
     markUserEnvironmentSessionsRead(options: MarkUserEnvironmentReadOptions): Promise<UserEnvironmentState["readAtBySessionId"]>;
     createSession(options?: CreateSessionOptions): Promise<EnvironmentSession>;
@@ -363,6 +398,13 @@ declare class Environment {
     }): Promise<EnvironmentSession>;
     closeSession(sessionId: string, session?: EnvironmentSession | null): Promise<void>;
     listFeedback(): Promise<EnvironmentFeedbackRecord[]>;
+    recordManualAction(input: RecordManualActionInput): Promise<ManualActionRecordResult>;
+    listManualActions(options?: ManualActionListOptions): Promise<SessionCollectionListResult<ManualActionOccurrence>>;
+    suggestManualActions(options?: ManualActionSuggestionOptions): Promise<{
+        items: ManualActionSuggestion[];
+    }>;
+    listArtifactApprovals(options?: ArtifactApprovalTaskListOptions): Promise<SessionCollectionListResult<ArtifactApprovalTask>>;
+    decideArtifactApproval(approvalTaskId: string, input: ArtifactApprovalDecisionInput): Promise<ArtifactApprovalDecisionResult>;
     private getRuntimeBaseUrl;
     private controlPlaneRequest;
     private static normalizeGraphPathSegment;
@@ -707,6 +749,35 @@ declare class EnvironmentSession extends Session {
     get jobs(): {
         list: (options?: SessionJobListOptions) => Promise<SessionCollectionListResult<SessionJobRecord>>;
         get: (jobId: string) => Promise<SessionJobRecord>;
+        latest: (options?: Pick<SessionJobListOptions, "status">) => Promise<SessionJobRecord | null>;
+    };
+    get artifacts(): {
+        list: (options?: SessionArtifactListOptions) => Promise<SessionCollectionListResult<SessionArtifactRecord>>;
+        listForLatestJob: (options?: Omit<SessionArtifactListOptions, "jobId" | "latestJob">) => Promise<SessionCollectionListResult<SessionArtifactRecord>>;
+        get: (artifactId: string) => Promise<SessionArtifactRecord>;
+        create: (artifact: Partial<SessionArtifactRecord> & {
+            label: string;
+        }) => Promise<SessionArtifactRecord>;
+        updateInputs: (artifactId: string, patch: {
+            inputValues?: Record<string, unknown>;
+            relationships?: Record<string, string | string[] | null>;
+            expectedUpdatedAt?: number;
+        }) => Promise<SessionArtifactRecord>;
+        validate: (artifactId: string) => Promise<SessionArtifactValidationResult>;
+        execute: (artifactId: string, options: SessionArtifactExecutionOptions) => Promise<SessionArtifactExecutionResult>;
+        approve: (artifactId: string, options: SessionArtifactApprovalOptions) => Promise<SessionArtifactExecutionResult>;
+        cancel: (artifactId: string) => Promise<SessionArtifactRecord>;
+    };
+    get manualActions(): {
+        record: (input: RecordManualActionInput) => Promise<ManualActionRecordResult>;
+        list: (options?: ManualActionListOptions) => Promise<SessionCollectionListResult<ManualActionOccurrence>>;
+        suggest: (options?: ManualActionSuggestionOptions) => Promise<{
+            items: ManualActionSuggestion[];
+        }>;
+    };
+    get artifactApprovals(): {
+        list: (options?: ArtifactApprovalTaskListOptions) => Promise<SessionCollectionListResult<ArtifactApprovalTask>>;
+        decide: (approvalTaskId: string, input: ArtifactApprovalDecisionInput) => Promise<ArtifactApprovalDecisionResult>;
     };
     get files(): {
         list: (options?: SessionCollectionListOptions & {
@@ -755,6 +826,8 @@ declare class EnvironmentSession extends Session {
         errors: string[];
     }>;
     recordObject(options: RecordObjectOptions): Promise<RecordObjectResult>;
+    recordState(input: EnvironmentStateUpdateInput): Promise<RecordObjectResult>;
+    state(target: EnvironmentStateTarget): EnvironmentStateProxy;
     recordObjects(records: RecordObjectOptions[], options?: RecordObjectsOptions): Promise<RecordObjectResult[]>;
     enqueueRecordImport(records: RecordObjectOptions[], options?: RecordImportOptions): Promise<RecordImport>;
     listRecordImports(status?: RecordImportStatus): Promise<RecordImport[]>;
@@ -903,15 +976,19 @@ declare class Granular {
     private sortEnvironmentsByRecency;
     private resolveOpenEnvironmentData;
     /**
-     * List active (open) sessions for an environment — each session is one agent conversation thread.
+     * List indexed sessions using ownership filters and bounded pagination.
+     */
+    listSessions(options: ConversationSessionListOptions): Promise<ConversationSessionInfo[]>;
+    /**
+     * List active (open) sessions for an environment.
      */
-    listOpenSessions(filters: {
+    listOpenSessions(filters: Omit<ConversationSessionListOptions, "status"> & {
         environmentId: string;
     }): Promise<ConversationSessionInfo[]>;
     /**
      * List closed sessions for an environment (conversations that have disconnected).
      */
-    listClosedSessions(filters: {
+    listClosedSessions(filters: Omit<ConversationSessionListOptions, "status"> & {
         environmentId: string;
     }): Promise<ConversationSessionInfo[]>;
     getUserEnvironmentState(options: UserEnvironmentStateOptions & {
@@ -920,7 +997,6 @@ declare class Granular {
     markUserEnvironmentSessionsRead(options: MarkUserEnvironmentReadOptions & {
         environmentId: string;
     }): Promise<UserEnvironmentState["readAtBySessionId"]>;
-    private listSessionsForEnvironment;
     private normalizeConversationSession;
     private normalizeUserEnvironmentState;
     private static coerceIsoDate;
@@ -931,6 +1007,7 @@ declare class Granular {
     createSession(options: {
         environmentId: string;
         clientId?: string;
+        sessionScope?: CreateSessionOptions["sessionScope"];
         initialHeap?: CreateSessionOptions["initialHeap"];
     }): Promise<EnvironmentSession>;
     /**

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-export { E as Environment, a as EnvironmentSession, G as Granular, O as OntologyHandle, S as Session, W as WSClient } from './client-B-MPVvDr.mjs';
-import { E as EndpointMode, T as ToolWithHandler, a as EffectHandlerContext, M as ManifestEffectMetamodelSpec, R as ResolvedEffectBehaviors, S as SessionHeapEntry, b as SessionHeapList, c as SessionHeapSnapshot, P as Prompt, d as SessionTranscriptEntry } from './spend-CStuOBXb.mjs';
-export { c7 as APIError, K as AccessTokenProvider, af as Assignment, ag as AssignmentListResponse, aq as Build, as as BuildListResponse, ah as BuildPolicy, ap as BuildStatus, C as ConditionIR, J as ConditionalPolicySpec, Z as ConnectOptions, aW as ConversationAppendResult, aV as ConversationMessageInput, aU as ConversationMessageShowRefs, $ as ConversationSessionInfo, al as CreateEnvironmentData, ad as CreatePermissionProfileData, a9 as CreateSandboxData, _ as CreateSessionOptions, bu as DefineRelationshipOptions, c8 as DeleteResponse, D as DomainState, aJ as EffectHandler, aG as EffectInfo, aA as EffectInvocationMetadata, az as EffectInvocationMode, aB as EffectSchema, aE as EffectVersionSelector, aC as EffectWithHandler, aI as EffectsChangedEvent, ak as EnvironmentData, aR as EnvironmentFeedbackRecord, bM as EnvironmentImporter, bL as EnvironmentImporterImportOptions, am as EnvironmentListResponse, bG as EnvironmentRecordImportSummary, bJ as EnvironmentSetupLifecycleStatus, bK as EnvironmentSetupSummary, bH as EnvironmentSetupTriggerReason, U as GranularAuth, Q as GranularOptions, a6 as GranularQuotaPolicy, a7 as GranularQuotaProgress, G as GranularSpendContext, c6 as GraphQLResult, aK as InstanceEffectHandler, I as InstanceToolHandler, aT as Job, aP as JobFeedbackInput, aO as JobFeedbackMetadata, aQ as JobFeedbackRecord, aM as JobFeedbackSentiment, aN as JobFeedbackToolCall, aL as JobStatus, aS as JobSubmitResult, L as LimitPolicySpec, an as Manifest, bY as ManifestApprovalRequiredSpec, c5 as ManifestContent, bW as ManifestDryRunSpec, b$ as ManifestEffectDeclaration, b_ as ManifestEffectSchema, bP as ManifestEnumRuleSpec, c1 as ManifestEventStreamDef, c0 as ManifestEventTypeDef, bQ as ManifestFilterBySpec, c3 as ManifestImport, ao as ManifestListResponse, c2 as ManifestOperation, bV as ManifestPostConditionSpec, bN as ManifestPropertySpec, bZ as ManifestRelationshipDef, bX as ManifestReverseSpec, bU as ManifestStateMachineSpec, bS as ManifestStateMachineStateSpec, bT as ManifestStateMachineTransitionSpec, bO as ManifestValidationOperator, bR as ManifestValidationRuleSpec, c4 as ManifestVolume, bi as MarkUserEnvironmentReadOptions, y as MatchedPolicy, bs as ModelRef, N as NormalizedOpenAIUsage, i as OPENAI_MODEL_PRICING_USD_PER_MILLION, O as OpenAIModelPricing, h as OpenAITokenSpend, l as OpenAIUsageSpendEvent, Y as OpenEnvironmentOptions, H as PermissionActionSpec, F as PermissionPolicySpec, ac as PermissionProfile, B as PermissionProfileFile, ae as PermissionProfileListResponse, ab as PermissionRules, z as PolicyDecision, A as PolicyEvaluationContext, v as PolicyOperator, w as PolicyOrigin, q as PolicyOutcome, u as PolicyPredicateSource, x as PolicyRuleIR, s as PolicySource, aD as PublishEffectsResult, f as PublishToolsResult, a5 as QuotaLineItemFilter, a2 as QuotaPeriod, a1 as QuotaScopeType, a3 as QuotaStatus, bm as RPCRequest, bp as RPCRequestFromServer, bn as RPCResponse, bF as RecordImport, bE as RecordImportItem, bC as RecordImportItemStatus, bA as RecordImportOptions, bD as RecordImportStats, bB as RecordImportStatus, bz as RecordImportWriteMode, b8 as RecordMentionInput, bv as RecordObjectOptions, bw as RecordObjectResult, bx as RecordObjectsChunkInfo, by as RecordObjectsOptions, m as RecordOpenAIUsageSpendOptions, o as RecordOpenAIUsageSpendResult, b7 as RecordSearchOptions, b6 as RecordSearchResult, W as RecordUserOptions, bt as RelationshipInfo, ay as ResolvedEffectApprovalRequired, aw as ResolvedEffectDryRun, av as ResolvedEffectPostCondition, ax as ResolvedEffectReverse, bI as RunEnvironmentImporterOptions, a8 as Sandbox, aa as SandboxListResponse, au as SemanticVersionDiff, at as SemanticVersionDiffEntry, ba as SessionCollectionListOptions, bc as SessionCollectionListResult, aX as SessionConversationMessage, b9 as SessionDocumentResult, a_ as SessionFileKind, b0 as SessionFileRecord, aZ as SessionFileSource, a$ as SessionFileStatus, b1 as SessionFileUploadOptions, b3 as SessionHeapFieldType, b4 as SessionHeapFieldValue, b5 as SessionHeapVariable, bb as SessionJobListOptions, b2 as SessionJobRecord, aY as SessionTimelineEvent, a0 as SpendLineItemType, a4 as SpendSummary, c9 as StreamEvent, cb as StreamStats, ca as StreamSubscription, X as Subject, bo as SyncMessage, g as ToolHandler, aF as ToolInfo, bq as ToolInvokeParams, br as ToolResultParams, e as ToolSchema, aH as ToolsChangedEvent, V as User, be as UserEnvironmentMessagePreview, bd as UserEnvironmentPrompt, bf as UserEnvironmentSessionState, bg as UserEnvironmentState, bh as UserEnvironmentStateOptions, ar as Version, aj as VersionTag, ai as VersionTracking, bl as WSClientOptions, bj as WSDisconnectInfo, bk as WSReconnectErrorInfo, p as buildOpenAISpendEventId, k as calculateOpenAITokenSpend, j as getOpenAIModelPricing, n as normalizeOpenAIUsage, r as recordOpenAIUsageSpend, t as toGranularHttpBase } from './spend-CStuOBXb.mjs';
-export { BuildGranularAgentSystemPromptInput, GeneratedJobCodeIssue, GranularAgentExecutionCheckpoint, GranularAgentHeapSummaryOptions, GranularAgentPromptCapabilities, GranularAgentReferentFocus, GranularAgentSessionContext, GranularAgentToolInfo, GranularAgentWorkflowFocus, GranularReasoningTraceChunkResult, GranularReasoningTraceOptions, HarnessContinuationDecision, HarnessControllerBudgets, HarnessProjectionOptions, HarnessPromptLike, HarnessRenderedContinuation, HarnessRenderedPrompt, HarnessTemplate, HarnessTemplateManifest, HarnessTemplateSelectionOptions, HarnessTemplateStatus, HarnessVerifierSnapshot, HarnessVerifierSnapshotInput, ReviewGeneratedJobCodeOptions, buildContinuationInstruction, buildContinuationInstructionFromTemplate, buildGranularAgentCheckpointBlock, buildGranularAgentDomainBlock, buildGranularAgentFileBlock, buildGranularAgentHeapBlock, buildGranularAgentLoopBlock, buildGranularAgentReferentBlock, buildGranularAgentRuntimeImportsBlock, buildGranularAgentSessionBlock, buildGranularAgentSystemPrompt, buildGranularAgentSystemPromptFromTemplate, buildGranularAgentToolBlock, buildGranularAgentWorkflowBlock, consumeGranularReasoningOnlyChunk, consumeGranularReasoningTraceChunk, createHarnessVerifierSnapshot, evaluateContinuation, getCurrentClosureId, getDefaultHarnessTemplateId, getExclusivePromptTarget, hasOpenPrompt, hashHarnessTemplateValue, listHarnessTemplates, projectConversationReferentFocus, projectConversationReferentSummary, projectHeapSummary, projectLoopSummary, projectSessionFileSummary, projectWorkflowFocus, projectWorkflowSummary, renderContinuationInstructionFromTemplate, renderGranularAgentSystemPromptFromTemplate, resolveHarnessTemplate, reviewGeneratedJobCode, stripGranularReasoningTrace, validateHarnessTemplateManifest } from './agent-harness.mjs';
+export { E as Environment, a as EnvironmentSession, G as Granular, O as OntologyHandle, S as Session, W as WSClient } from './client-djorlOpn.mjs';
+import { E as EndpointMode, T as ToolWithHandler, a as EffectHandlerContext, M as ManifestEffectMetamodelSpec, R as ResolvedEffectBehaviors, S as SessionHeapEntry, b as SessionHeapList, c as SessionHeapSnapshot, P as Prompt, d as SessionTranscriptEntry } from './spend-BA-jZwZ0.mjs';
+export { cL as APIError, A as AccessTokenProvider, bf as ArtifactApprovalDecisionInput, bg as ArtifactApprovalDecisionResult, bd as ArtifactApprovalTask, be as ArtifactApprovalTaskListOptions, bc as ArtifactApprovalTaskStatus, a9 as Assignment, aa as AssignmentListResponse, ak as Build, am as BuildListResponse, ab as BuildPolicy, aj as BuildStatus, C as ConditionIR, J as ConnectOptions, aU as ConversationActionSuggestion, aY as ConversationAppendResult, aV as ConversationMessageAction, aX as ConversationMessageInput, aW as ConversationMessagePart, aO as ConversationMessageShowRefs, L as ConversationSessionInfo, V as ConversationSessionListOptions, Q as ConversationSessionListStatus, aP as ConversationTableCell, aQ as ConversationTableColumn, aT as ConversationTableProjection, aS as ConversationTableRow, aR as ConversationTableRowReference, af as CreateEnvironmentData, a7 as CreatePermissionProfileData, a3 as CreateSandboxData, K as CreateSessionOptions, bU as DefineRelationshipOptions, cM as DeleteResponse, D as DomainState, aD as EffectHandler, aA as EffectInfo, au as EffectInvocationMetadata, at as EffectInvocationMode, av as EffectSchema, ay as EffectVersionSelector, aw as EffectWithHandler, aC as EffectsChangedEvent, ae as EnvironmentData, aL as EnvironmentFeedbackRecord, cg as EnvironmentImporter, cf as EnvironmentImporterImportOptions, ag as EnvironmentListResponse, ca as EnvironmentRecordImportSummary, cd as EnvironmentSetupLifecycleStatus, ce as EnvironmentSetupSummary, cb as EnvironmentSetupTriggerReason, b_ as EnvironmentStateMachineProxy, bY as EnvironmentStateObservationInput, b$ as EnvironmentStateProxy, bX as EnvironmentStateTarget, bZ as EnvironmentStateUpdateInput, z as GranularAuth, y as GranularOptions, a0 as GranularQuotaPolicy, a1 as GranularQuotaProgress, G as GranularSpendContext, cK as GraphQLResult, aE as InstanceEffectHandler, I as InstanceToolHandler, aN as Job, aJ as JobFeedbackInput, aI as JobFeedbackMetadata, aK as JobFeedbackRecord, aG as JobFeedbackSentiment, aH as JobFeedbackToolCall, aF as JobStatus, aM as JobSubmitResult, ah as Manifest, cz as ManifestApprovalRequiredSpec, cJ as ManifestContent, cA as ManifestCreatesSpec, cx as ManifestDryRunSpec, cD as ManifestEffectDeclaration, cC as ManifestEffectSchema, cj as ManifestEnumRuleSpec, cF as ManifestEventStreamDef, cE as ManifestEventTypeDef, ck as ManifestFilterBySpec, cH as ManifestImport, ai as ManifestListResponse, cG as ManifestOperation, cw as ManifestPostConditionSpec, ch as ManifestPropertySpec, cB as ManifestRelationshipDef, cy as ManifestReverseSpec, cv as ManifestStateMachineSpec, cm as ManifestStateMachineStateSpec, cu as ManifestStateMachineTransitionSpec, co as ManifestStateTransitionActionSpec, cp as ManifestStateTransitionAssigneeSpec, ct as ManifestStateTransitionExpectedOutcomeSpec, cn as ManifestStateTransitionInputBinding, cs as ManifestStateTransitionPermissionSpec, cq as ManifestStateTransitionRelatedStateRequirementSpec, cr as ManifestStateTransitionRequirementsSpec, ci as ManifestValidationOperator, cl as ManifestValidationRuleSpec, cI as ManifestVolume, bo as ManualActionListOptions, bm as ManualActionOccurrence, bn as ManualActionRecordResult, bk as ManualActionRelatedRecord, bi as ManualActionSource, bh as ManualActionStatus, bp as ManualActionSuggestion, bq as ManualActionSuggestionOptions, bj as ManualActionTarget, bI as MarkUserEnvironmentReadOptions, x as MatchedPolicy, bS as ModelRef, N as NormalizedOpenAIUsage, i as OPENAI_MODEL_PRICING_USD_PER_MILLION, O as OpenAIModelPricing, h as OpenAITokenSpend, l as OpenAIUsageSpendEvent, H as OpenEnvironmentOptions, a6 as PermissionProfile, a8 as PermissionProfileListResponse, a5 as PermissionRules, u as PolicyOperator, v as PolicyOrigin, s as PolicyPredicateSource, w as PolicyRuleIR, q as PolicySource, ax as PublishEffectsResult, f as PublishToolsResult, $ as QuotaLineItemFilter, Y as QuotaPeriod, X as QuotaScopeType, Z as QuotaStatus, bM as RPCRequest, bP as RPCRequestFromServer, bN as RPCResponse, c9 as RecordImport, c8 as RecordImportItem, c6 as RecordImportItemStatus, c4 as RecordImportOptions, c7 as RecordImportStats, c5 as RecordImportStatus, c3 as RecordImportWriteMode, bl as RecordManualActionInput, by as RecordMentionInput, bV as RecordObjectOptions, c0 as RecordObjectResult, bW as RecordObjectStateValue, c1 as RecordObjectsChunkInfo, c2 as RecordObjectsOptions, m as RecordOpenAIUsageSpendOptions, o as RecordOpenAIUsageSpendResult, bx as RecordSearchOptions, bw as RecordSearchResult, B as RecordUserOptions, bT as RelationshipInfo, as as ResolvedEffectApprovalRequired, aq as ResolvedEffectDryRun, ap as ResolvedEffectPostCondition, ar as ResolvedEffectReverse, cc as RunEnvironmentImporterOptions, a2 as Sandbox, a4 as SandboxListResponse, ao as SemanticVersionDiff, an as SemanticVersionDiffEntry, bb as SessionArtifactApprovalOptions, b5 as SessionArtifactAutonomyPolicy, ba as SessionArtifactExecutionOptions, b9 as SessionArtifactExecutionResult, b4 as SessionArtifactKind, b7 as SessionArtifactListOptions, b6 as SessionArtifactRecord, b3 as SessionArtifactStatus, b8 as SessionArtifactValidationResult, bA as SessionCollectionListOptions, bC as SessionCollectionListResult, aZ as SessionConversationMessage, bz as SessionDocumentResult, b0 as SessionFileKind, b2 as SessionFileRecord, a$ as SessionFileSource, b1 as SessionFileStatus, br as SessionFileUploadOptions, bt as SessionHeapFieldType, bu as SessionHeapFieldValue, bv as SessionHeapVariable, bB as SessionJobListOptions, bs as SessionJobRecord, a_ as SessionTimelineEvent, W as SpendLineItemType, _ as SpendSummary, cN as StreamEvent, cP as StreamStats, cO as StreamSubscription, F as Subject, bO as SyncMessage, g as ToolHandler, az as ToolInfo, bQ as ToolInvokeParams, bR as ToolResultParams, e as ToolSchema, aB as ToolsChangedEvent, U as User, bE as UserEnvironmentMessagePreview, bD as UserEnvironmentPrompt, bF as UserEnvironmentSessionState, bG as UserEnvironmentState, bH as UserEnvironmentStateOptions, al as Version, ad as VersionTag, ac as VersionTracking, bL as WSClientOptions, bJ as WSDisconnectInfo, bK as WSReconnectErrorInfo, p as buildOpenAISpendEventId, k as calculateOpenAITokenSpend, j as getOpenAIModelPricing, n as normalizeOpenAIUsage, r as recordOpenAIUsageSpend, t as toGranularHttpBase } from './spend-BA-jZwZ0.mjs';
+export { BuildGranularAgentSystemPromptInput, GeneratedJobCodeIssue, GranularAgentExecutionCheckpoint, GranularAgentHeapSummaryOptions, GranularAgentManualActionMemorySuggestion, GranularAgentPromptCapabilities, GranularAgentReferentFocus, GranularAgentSessionContext, GranularAgentToolInfo, GranularAgentWorkflowFocus, GranularReasoningTraceChunkResult, GranularReasoningTraceOptions, HarnessContinuationDecision, HarnessControllerBudgets, HarnessProjectionOptions, HarnessPromptLike, HarnessRenderedContinuation, HarnessRenderedPrompt, HarnessTemplate, HarnessTemplateManifest, HarnessTemplateSelectionOptions, HarnessTemplateStatus, HarnessVerifierSnapshot, HarnessVerifierSnapshotInput, ReviewGeneratedJobCodeOptions, buildContinuationInstruction, buildContinuationInstructionFromTemplate, buildGranularAgentCheckpointBlock, buildGranularAgentDomainBlock, buildGranularAgentFileBlock, buildGranularAgentHeapBlock, buildGranularAgentLoopBlock, buildGranularAgentManualActionBlock, buildGranularAgentManualActionMemorySummary, buildGranularAgentReferentBlock, buildGranularAgentRuntimeImportsBlock, buildGranularAgentSessionBlock, buildGranularAgentSystemPrompt, buildGranularAgentSystemPromptFromTemplate, buildGranularAgentToolBlock, buildGranularAgentWorkflowBlock, consumeGranularReasoningOnlyChunk, consumeGranularReasoningTraceChunk, createHarnessVerifierSnapshot, evaluateContinuation, getCurrentClosureId, getDefaultHarnessTemplateId, getExclusivePromptTarget, hasOpenPrompt, hashHarnessTemplateValue, listHarnessTemplates, projectConversationReferentFocus, projectConversationReferentSummary, projectHeapSummary, projectLoopSummary, projectSessionFileSummary, projectWorkflowFocus, projectWorkflowSummary, renderContinuationInstructionFromTemplate, renderGranularAgentSystemPromptFromTemplate, resolveHarnessTemplate, reviewGeneratedJobCode, stripGranularReasoningTrace, validateHarnessTemplateManifest } from './agent-harness.mjs';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';
 
@@ -29,6 +29,105 @@ type EffectRuntimeRequest = {
 declare function normalizeEffectBehaviors(value?: ManifestEffectMetamodelSpec | ResolvedEffectBehaviors | null): ResolvedEffectBehaviors;
 declare function invokeRegisteredEffect(effectMap: Map<string, ToolWithHandler>, request: EffectRuntimeRequest): Promise<unknown>;
 
+interface ValidationRuleEvaluationInput {
+    operator?: string | null;
+    stringValue?: string;
+    string_value?: string;
+    numberValue?: number;
+    number_value?: number;
+    booleanValue?: boolean;
+    boolean_value?: boolean;
+    message?: string | null;
+}
+interface ValidationRuleEvaluationResult {
+    passed: boolean;
+    operator: string;
+    message?: string | null;
+}
+declare function evaluateValidationRule(value: unknown, rule: ValidationRuleEvaluationInput): ValidationRuleEvaluationResult;
+declare function validationRuleFailureMessage(path: string, rule: ValidationRuleEvaluationInput): string;
+
+type PolicyOutcome = "allow" | "confirm" | "deny";
+type PolicySource = "manifest" | "permissionProfile" | "builtin";
+type PolicyOrigin = {
+    kind: "manifest";
+    manifestId?: string;
+    effectKey: string;
+} | {
+    kind: "permissionProfile";
+    profileName: string;
+    permissionProfileVersionId?: string;
+    source: PolicySource;
+};
+interface MatchedPolicy {
+    id: string;
+    outcome: PolicyOutcome;
+    origin: PolicyOrigin;
+    reason?: string;
+    summary: string;
+}
+interface PolicyDecision {
+    outcome: PolicyOutcome;
+    matches: MatchedPolicy[];
+}
+interface PolicyEvaluationContext {
+    input?: Record<string, unknown> | null;
+    object?: Record<string, unknown> | null;
+    stateMachines?: Record<string, string | null | undefined> | null;
+}
+interface PermissionProfileFile {
+    schemaVersion?: number;
+    name: string;
+    label?: string;
+    description?: string;
+    extends?: string;
+    defaultsOwnerName?: string;
+    source?: PolicySource;
+    sourcePath?: string;
+    defaults?: {
+        actionPolicy?: PolicyOutcome;
+    };
+    policies?: PermissionPolicySpec[];
+    actions?: PermissionActionSpec[];
+}
+interface PermissionPolicySpec {
+    id?: string;
+    ownerProfileName?: string;
+    action?: string;
+    on?: string;
+    decision?: PolicyOutcome;
+    outcome?: PolicyOutcome;
+    reason?: string;
+    when?: unknown;
+}
+interface PermissionActionSpec {
+    id?: string;
+    ownerProfileName?: string;
+    action: string;
+    on?: string;
+    allow?: "always";
+    deny?: "always";
+    confirm?: "always";
+    reason?: string;
+    allowWhen?: ConditionalPolicySpec[];
+    confirmWhen?: ConditionalPolicySpec[];
+    denyWhen?: ConditionalPolicySpec[];
+    limits?: LimitPolicySpec[];
+}
+interface ConditionalPolicySpec {
+    id?: string;
+    reason?: string;
+    when: unknown;
+}
+interface LimitPolicySpec {
+    id?: string;
+    input: string | string[];
+    upTo?: number;
+    above?: number;
+    decision: PolicyOutcome;
+    reason?: string;
+}
+
 interface JobPresentation {
     responseText: string | null;
     entries: SessionHeapEntry[];
@@ -75,4 +174,4 @@ declare function buildSessionTranscript(input: {
     sessionHeap?: SessionHeapSnapshot;
 }): SessionTranscriptEntry[];
 
-export { EffectHandlerContext, EndpointMode, type JobPresentation, ManifestEffectMetamodelSpec, type NormalizedPromptChoiceOption, Prompt, ResolvedEffectBehaviors, SessionHeapEntry, SessionHeapList, SessionHeapSnapshot, SessionTranscriptEntry, ToolWithHandler, buildSessionTranscript, extractPromptTokens, invokeRegisteredEffect, isLocalApiUrl, normalizeEffectBehaviors, normalizePrompt, normalizePromptChoiceOption, normalizePromptText, normalizePromptType, resolveApiUrl, resolveAuthTokenForApiUrl, resolveJobPresentation, resolvePromptAnswer, scorePromptChoiceMatch };
+export { type ConditionalPolicySpec, EffectHandlerContext, EndpointMode, type JobPresentation, type LimitPolicySpec, ManifestEffectMetamodelSpec, type NormalizedPromptChoiceOption, type PermissionActionSpec, type PermissionPolicySpec, type PermissionProfileFile, type PolicyDecision, type PolicyEvaluationContext, type PolicyOutcome, Prompt, ResolvedEffectBehaviors, SessionHeapEntry, SessionHeapList, SessionHeapSnapshot, SessionTranscriptEntry, ToolWithHandler, type ValidationRuleEvaluationInput, type ValidationRuleEvaluationResult, buildSessionTranscript, evaluateValidationRule, extractPromptTokens, invokeRegisteredEffect, isLocalApiUrl, normalizeEffectBehaviors, normalizePrompt, normalizePromptChoiceOption, normalizePromptText, normalizePromptType, resolveApiUrl, resolveAuthTokenForApiUrl, resolveJobPresentation, resolvePromptAnswer, scorePromptChoiceMatch, validationRuleFailureMessage };