@granular-software/sdk 0.4.31 → 0.4.32

package/dist/{client-CTH1hfwe.d.ts → client-C2Gk641P.d.ts}

@@ -9,7 +9,7 @@ import { Doc } from '@automerge/automerge/slim';
  * Configuration for the Granular client
  */
 type AccessTokenProvider = () => Promise<string | null | undefined> | string | null | undefined;
-type EndpointMode = "auto" | "local" | "production";
+type EndpointMode = 'auto' | 'local' | 'production';
 interface GranularOptions {
     /** Your Granular API key (for service/CLI auth; use with GRANULAR_API_KEY) */
     apiKey?: string;
@@ -86,15 +86,16 @@ interface Subject {
     updatedAt: number;
 }
 /**
- * Options for opening or resolving an ontology environment for one user.
+ * Options for opening an ontology environment for one delegated subject.
  *
- * This does **not** open a session. Use `environment.sessions.create()` after
- * opening the environment when you need a live runtime connection.
+ * This does not open a live runtime session. Use
+ * `environment.sessions.create()` or `granular.createSession({ environmentId })`
+ * when you need a conversation/session with jobs, prompts, heap, and effects.
  */
 interface OpenEnvironmentOptions {
-    /** The ontology name or ID to open */
+    /** The ontology name or ID to open. */
     ontology: string;
-    /** Version channel to follow, typically `dev` or `prod` */
+    /** Version channel to follow, typically `dev` or `prod`. */
     tag?: string;
     /**
      * External user identifier from your app.
@@ -108,9 +109,9 @@ interface OpenEnvironmentOptions {
      * Exactly one of `userId`, `granularId`, or `user` should be provided.
      */
     granularId?: string;
-    /** Optional display name used when upserting the user */
+    /** Optional display name used when upserting the user. */
     name?: string;
-    /** Optional email used when upserting the user */
+    /** Optional email used when upserting the user. */
     email?: string;
     /**
      * Permission profile names or IDs to ensure before opening the environment.
@@ -124,14 +125,14 @@ interface OpenEnvironmentOptions {
      * the newest tag target instead of reusing the outdated one.
      */
     createFreshIfOutdated?: boolean;
-    /** Backwards-compatible user object returned from recordUser() */
+    /** Backwards-compatible user object returned from `recordUser()`. */
     user?: User;
 }
 /**
  * Deprecated compatibility alias for the legacy `connect()` entry point.
  *
- * `connect()` now resolves an environment handle and no longer opens a
- * runtime session automatically. Prefer `openEnvironment()` for new code.
+ * `connect()` now resolves an environment handle and no longer opens a runtime
+ * session automatically. Prefer `openEnvironment()` for new code.
  */
 interface ConnectOptions extends OpenEnvironmentOptions {
     /** @deprecated Legacy explicit environment slot name. Prefer `tag`. */
@@ -167,7 +168,7 @@ interface ConversationSessionInfo {
     environmentId: string;
     versionId?: string | null;
     docId: string;
-    status: "active" | "closed" | "expired";
+    status: 'active' | 'closed' | 'expired';
     createdAt: string;
     lastSeenAt: string;
     summary?: string | null;
@@ -275,7 +276,7 @@ interface AssignmentListResponse {
  * pin themselves to one immutable ontology version.
  */
 interface BuildPolicy {
-    mode: "tag" | "current" | "pinned";
+    mode: 'tag' | 'current' | 'pinned';
     buildId?: string;
     versionId?: string;
     tagId?: string;
@@ -286,7 +287,7 @@ interface VersionTag {
     tagId: string;
     sandboxId: string;
     name: string;
-    kind: "channel" | "release" | "system";
+    kind: 'channel' | 'release' | 'system';
     targetBuildId?: string | null;
     targetVersionId?: string | null;
     description?: string | null;
@@ -311,7 +312,7 @@ interface EnvironmentData {
     tag?: VersionTag | null;
     tracking?: BuildPolicy;
     buildPolicy: BuildPolicy;
-    updateState?: "up_to_date" | "update_available" | "upgrading" | "failed";
+    updateState?: 'up_to_date' | 'update_available' | 'upgrading' | 'failed';
     createdAt: number;
     updatedAt: number;
 }
@@ -360,7 +361,7 @@ interface Manifest {
 interface ManifestListResponse {
     items: Manifest[];
 }
-type BuildStatus = "queued" | "building" | "completed" | "failed" | "canceled";
+type BuildStatus = 'queued' | 'building' | 'completed' | 'failed' | 'canceled';
 /**
  * An immutable ontology version derived from a specific manifest revision.
  *
@@ -395,8 +396,8 @@ interface BuildListResponse {
 }
 interface SemanticVersionDiffEntry {
     operationId: string;
-    kind: "create" | "update" | "relationship" | "effect" | "eventStream" | "unknown";
-    changeType: "added" | "removed" | "changed";
+    kind: 'create' | 'update' | 'relationship' | 'effect' | 'eventStream' | 'unknown';
+    changeType: 'added' | 'removed' | 'changed';
     label: string;
     additive: boolean;
     breaking: boolean;
@@ -458,7 +459,7 @@ interface ResolvedEffectBehaviors {
     reverse?: ResolvedEffectReverse;
     approvalRequired?: ResolvedEffectApprovalRequired;
 }
-type EffectInvocationMode = "execute" | "dryRun" | "reverse";
+type EffectInvocationMode = 'execute' | 'dryRun' | 'reverse';
 interface EffectInvocationMetadata {
     mode?: EffectInvocationMode;
     reverseHandler?: string;
@@ -515,9 +516,9 @@ interface ToolSchema {
      * ```
      */
     outputSchema?: Record<string, unknown>;
-    stability?: "stable" | "experimental" | "deprecated";
+    stability?: 'stable' | 'experimental' | 'deprecated';
     provenance?: {
-        source: "mcp" | "custom";
+        source: 'mcp' | 'custom';
     };
     tags?: string[];
     /**
@@ -624,8 +625,8 @@ interface EffectsChangedEvent extends ToolsChangedEvent {
 }
 type EffectHandler = ToolHandler;
 type InstanceEffectHandler = InstanceToolHandler;
-type JobStatus = "queued" | "running" | "awaitingTool" | "awaitingHuman" | "succeeded" | "failed" | "timeout" | "canceled";
-type JobFeedbackSentiment = "good" | "bad";
+type JobStatus = 'queued' | 'running' | 'awaitingTool' | 'awaitingHuman' | 'succeeded' | 'failed' | 'timeout' | 'canceled';
+type JobFeedbackSentiment = 'good' | 'bad';
 interface JobFeedbackToolCall {
     callId?: string;
     toolName?: string;
@@ -637,7 +638,7 @@ interface JobFeedbackToolCall {
     durationMs?: number | null;
 }
 interface JobFeedbackMetadata {
-    source: "sdk";
+    source: 'sdk';
     status: JobStatus;
     code: string;
     domainRevision?: string;
@@ -671,7 +672,7 @@ interface JobFeedbackRecord {
     updatedAt: number;
 }
 /**
- * Persisted feedback rows listed at the environment level.
+ * Persisted feedback row listed at the environment level.
  */
 interface EnvironmentFeedbackRecord {
     feedbackId: string;
@@ -701,11 +702,11 @@ interface Job {
     /** Attach user feedback to this job and persist it with job/session metadata */
     leaveFeedback(input: JobFeedbackInput): Promise<JobFeedbackRecord>;
     /** Subscribe to job events */
-    on(event: string, handler: (data: unknown) => void): void;
+    on(event: string, handler: (data: unknown) => void): () => void;
 }
 interface Prompt {
     id: string;
-    type: "confirm" | "choice" | "input";
+    type: 'confirm' | 'choice' | 'input';
     title: string;
     message: string;
     options?: Array<string | {
@@ -724,7 +725,7 @@ interface ConversationMessageShowRefs {
     variableNames?: string[];
 }
 interface ConversationMessageInput {
-    role: "user" | "assistant";
+    role: 'user' | 'assistant';
     content?: string;
     show?: ConversationMessageShowRefs;
     jobId?: string;
@@ -740,7 +741,7 @@ interface ConversationAppendResult {
 }
 interface SessionTranscriptEntry {
     id: string;
-    role: "user" | "assistant";
+    role: 'user' | 'assistant';
     content: string;
     timestamp: number;
     jobId?: string;
@@ -751,9 +752,9 @@ interface SessionTranscriptEntry {
     error?: string;
     show?: ConversationMessageShowRefs;
     historyContent?: string;
-    source: "conversation" | "job_code" | "job_result" | "job_prompt" | "job_agent_message";
+    source: 'conversation' | 'job_code' | 'job_result' | 'job_prompt' | 'job_agent_message';
 }
-type SessionHeapFieldType = "string" | "number" | "boolean" | "null" | "unknown";
+type SessionHeapFieldType = 'string' | 'number' | 'boolean' | 'null' | 'unknown';
 interface SessionHeapFieldValue {
     name: string;
     type: SessionHeapFieldType;
@@ -781,7 +782,7 @@ interface SessionHeapList {
 }
 interface SessionHeapVariable {
     name: string;
-    kind: "entry" | "list" | "scalar";
+    kind: 'entry' | 'list' | 'scalar';
     entryPath?: string;
     listName?: string;
     value?: string | number | boolean | null;
@@ -818,13 +819,13 @@ interface WSClientOptions {
     onReconnectError?: (info: WSReconnectErrorInfo) => void;
 }
 interface RPCRequest {
-    type: "rpc";
+    type: 'rpc';
     method: string;
     params: unknown;
     id: string;
 }
 interface RPCResponse {
-    type: "rpc_result" | "rpc_error";
+    type: 'rpc_result' | 'rpc_error';
     id: string;
     result?: unknown;
     error?: {
@@ -834,12 +835,12 @@ interface RPCResponse {
     };
 }
 interface SyncMessage {
-    type: "sync";
+    type: 'sync';
     message?: string | number[] | Uint8Array;
     data?: number[];
 }
 interface RPCRequestFromServer {
-    type: "rpc";
+    type: 'rpc';
     method: string;
     params: unknown;
     id: string;
@@ -883,7 +884,7 @@ interface RelationshipInfo {
     /** The foreign model type */
     foreign_model: ModelRef;
     /** Computed relationship kind: "one_to_one" | "one_to_many" | "many_to_one" | "many_to_many" */
-    relationship_kind: "one_to_one" | "one_to_many" | "many_to_one" | "many_to_many";
+    relationship_kind: 'one_to_one' | 'one_to_many' | 'many_to_one' | 'many_to_many';
 }
 /**
  * Options for defining a relationship between two model types
@@ -982,8 +983,8 @@ interface RecordObjectsOptions {
      */
     onChunkComplete?: (info: RecordObjectsChunkInfo) => void | Promise<void>;
 }
-type RecordImportStatus = "queued" | "processing" | "completed" | "failed" | "canceled";
-type RecordImportItemStatus = "queued" | "processing" | "completed" | "failed" | "canceled";
+type RecordImportStatus = 'queued' | 'processing' | 'completed' | 'failed' | 'canceled';
+type RecordImportItemStatus = 'queued' | 'processing' | 'completed' | 'failed' | 'canceled';
 interface RecordImportStats {
     totalRecords: number;
     queuedRecords: number;
@@ -1048,14 +1049,10 @@ interface ManifestPropertySpec {
     required?: boolean;
     note?: string | string[];
     enum?: string[] | ManifestEnumRuleSpec;
-    searchable?: boolean | {
-        enabled?: boolean;
-        phonetic?: boolean;
-    };
     filterBy?: boolean | string[] | ManifestFilterBySpec;
     validate?: ManifestValidationRuleSpec[];
 }
-type ManifestValidationOperator = "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "true" | "false" | "regex" | "contains" | "not_contains" | "starts_with" | "ends_with";
+type ManifestValidationOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'true' | 'false' | 'regex' | 'contains' | 'not_contains' | 'starts_with' | 'ends_with';
 interface ManifestEnumRuleSpec {
     values: string[];
     message?: string;
@@ -1144,7 +1141,7 @@ interface ManifestEffectDeclaration {
     isStatic?: boolean;
     inputSchema: ManifestEffectSchema;
     outputSchema?: ManifestEffectSchema;
-    stability?: "stable" | "experimental" | "deprecated";
+    stability?: 'stable' | 'experimental' | 'deprecated';
     tags?: string[];
     metamodels?: ManifestEffectMetamodelSpec;
 }
@@ -1205,7 +1202,7 @@ interface ManifestImport {
 }
 interface ManifestVolume {
     name: string;
-    scope: "sandbox" | "build" | "user";
+    scope: 'sandbox' | 'build' | 'user';
     imports?: ManifestImport[];
     operations: ManifestOperation[];
 }
@@ -1248,7 +1245,7 @@ interface StreamEvent {
     environmentId: string;
     sessionId?: string;
     subjectId?: string;
-    source: "sandbox" | "api";
+    source: 'sandbox' | 'api';
     isAcked: boolean;
     createdAt: number;
 }
@@ -1480,7 +1477,7 @@ declare class Session {
     /**
      * Subscribe to session events
      */
-    on(event: string, handler: (data: unknown) => void): void;
+    on(event: string, handler: (data: unknown) => void): () => void;
     /**
      * Unsubscribe from session events
      */

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-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 './client-CTH1hfwe.mjs';
-export { ba as APIError, A as AccessTokenProvider, y as Assignment, z as AssignmentListResponse, X as Build, Z as BuildListResponse, B as BuildPolicy, Q as BuildStatus, C as ConnectOptions, aq as ConversationAppendResult, ap as ConversationMessageInput, ao as ConversationMessageShowRefs, q as ConversationSessionInfo, J as CreateEnvironmentData, w as CreatePermissionProfileData, s as CreateSandboxData, p as CreateSessionOptions, aF as DefineRelationshipOptions, bb as DeleteResponse, D as DomainState, ad as EffectHandler, aa as EffectInfo, a5 as EffectInvocationMetadata, a4 as EffectInvocationMode, a6 as EffectSchema, a7 as EffectWithHandler, ac as EffectsChangedEvent, e as Environment, H as EnvironmentData, al as EnvironmentFeedbackRecord, K as EnvironmentListResponse, aP as EnvironmentRecordImportSummary, f as EnvironmentSession, G as Granular, l as GranularAuth, k as GranularOptions, b9 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, L as Manifest, a$ as ManifestApprovalRequiredSpec, b8 as ManifestContent, aZ as ManifestDryRunSpec, b2 as ManifestEffectDeclaration, b1 as ManifestEffectSchema, aS as ManifestEnumRuleSpec, b4 as ManifestEventStreamDef, b3 as ManifestEventTypeDef, aT as ManifestFilterBySpec, b6 as ManifestImport, N as ManifestListResponse, b5 as ManifestOperation, aY as ManifestPostConditionSpec, aQ as ManifestPropertySpec, b0 as ManifestRelationshipDef, a_ as ManifestReverseSpec, aX as ManifestStateMachineSpec, aV as ManifestStateMachineStateSpec, aW as ManifestStateMachineTransitionSpec, aR as ManifestValidationOperator, aU as ManifestValidationRuleSpec, b7 as ManifestVolume, aD as ModelRef, O as OntologyHandle, o as OpenEnvironmentOptions, v as PermissionProfile, x as PermissionProfileListResponse, u as PermissionRules, a8 as PublishEffectsResult, i as PublishToolsResult, ax as RPCRequest, aA as RPCRequestFromServer, ay as RPCResponse, aO as RecordImport, aN as RecordImportItem, aL as RecordImportItemStatus, aM as RecordImportStats, aK as RecordImportStatus, aG as RecordObjectOptions, aH as RecordObjectResult, aI as RecordObjectsChunkInfo, aJ as RecordObjectsOptions, m as RecordUserOptions, aE as RelationshipInfo, a3 as ResolvedEffectApprovalRequired, a1 as ResolvedEffectDryRun, a0 as ResolvedEffectPostCondition, a2 as ResolvedEffectReverse, r as Sandbox, t as SandboxListResponse, $ as SemanticVersionDiff, _ as SemanticVersionDiffEntry, g as Session, ar as SessionHeapFieldType, as as SessionHeapFieldValue, at as SessionHeapVariable, bc as StreamEvent, be as StreamStats, bd as StreamSubscription, n as Subject, az as SyncMessage, j as ToolHandler, a9 as ToolInfo, aB as ToolInvokeParams, aC as ToolResultParams, h as ToolSchema, ab as ToolsChangedEvent, U as User, Y as Version, F as VersionTag, V as VersionTracking, W as WSClient, aw as WSClientOptions, au as WSDisconnectInfo, av as WSReconnectErrorInfo } from './client-CTH1hfwe.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 './client-C2Gk641P.mjs';
+export { ba as APIError, A as AccessTokenProvider, y as Assignment, z as AssignmentListResponse, X as Build, Z as BuildListResponse, B as BuildPolicy, Q as BuildStatus, C as ConnectOptions, aq as ConversationAppendResult, ap as ConversationMessageInput, ao as ConversationMessageShowRefs, q as ConversationSessionInfo, J as CreateEnvironmentData, w as CreatePermissionProfileData, s as CreateSandboxData, p as CreateSessionOptions, aF as DefineRelationshipOptions, bb as DeleteResponse, D as DomainState, ad as EffectHandler, aa as EffectInfo, a5 as EffectInvocationMetadata, a4 as EffectInvocationMode, a6 as EffectSchema, a7 as EffectWithHandler, ac as EffectsChangedEvent, e as Environment, H as EnvironmentData, al as EnvironmentFeedbackRecord, K as EnvironmentListResponse, aP as EnvironmentRecordImportSummary, f as EnvironmentSession, G as Granular, l as GranularAuth, k as GranularOptions, b9 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, L as Manifest, a$ as ManifestApprovalRequiredSpec, b8 as ManifestContent, aZ as ManifestDryRunSpec, b2 as ManifestEffectDeclaration, b1 as ManifestEffectSchema, aS as ManifestEnumRuleSpec, b4 as ManifestEventStreamDef, b3 as ManifestEventTypeDef, aT as ManifestFilterBySpec, b6 as ManifestImport, N as ManifestListResponse, b5 as ManifestOperation, aY as ManifestPostConditionSpec, aQ as ManifestPropertySpec, b0 as ManifestRelationshipDef, a_ as ManifestReverseSpec, aX as ManifestStateMachineSpec, aV as ManifestStateMachineStateSpec, aW as ManifestStateMachineTransitionSpec, aR as ManifestValidationOperator, aU as ManifestValidationRuleSpec, b7 as ManifestVolume, aD as ModelRef, O as OntologyHandle, o as OpenEnvironmentOptions, v as PermissionProfile, x as PermissionProfileListResponse, u as PermissionRules, a8 as PublishEffectsResult, i as PublishToolsResult, ax as RPCRequest, aA as RPCRequestFromServer, ay as RPCResponse, aO as RecordImport, aN as RecordImportItem, aL as RecordImportItemStatus, aM as RecordImportStats, aK as RecordImportStatus, aG as RecordObjectOptions, aH as RecordObjectResult, aI as RecordObjectsChunkInfo, aJ as RecordObjectsOptions, m as RecordUserOptions, aE as RelationshipInfo, a3 as ResolvedEffectApprovalRequired, a1 as ResolvedEffectDryRun, a0 as ResolvedEffectPostCondition, a2 as ResolvedEffectReverse, r as Sandbox, t as SandboxListResponse, $ as SemanticVersionDiff, _ as SemanticVersionDiffEntry, g as Session, ar as SessionHeapFieldType, as as SessionHeapFieldValue, at as SessionHeapVariable, bc as StreamEvent, be as StreamStats, bd as StreamSubscription, n as Subject, az as SyncMessage, j as ToolHandler, a9 as ToolInfo, aB as ToolInvokeParams, aC as ToolResultParams, h as ToolSchema, ab as ToolsChangedEvent, U as User, Y as Version, F as VersionTag, V as VersionTracking, W as WSClient, aw as WSClientOptions, au as WSDisconnectInfo, av as WSReconnectErrorInfo } from './client-C2Gk641P.mjs';
 export { BuildGranularAgentSystemPromptInput, GeneratedJobCodeIssue, GranularAgentExecutionCheckpoint, GranularAgentHeapSummaryOptions, GranularAgentReferentFocus, GranularAgentSessionContext, GranularAgentToolInfo, GranularAgentWorkflowFocus, HarnessContinuationDecision, HarnessControllerBudgets, HarnessProjectionOptions, HarnessPromptLike, HarnessVerifierSnapshot, HarnessVerifierSnapshotInput, buildContinuationInstruction, buildGranularAgentCheckpointBlock, buildGranularAgentDomainBlock, buildGranularAgentHeapBlock, buildGranularAgentLoopBlock, buildGranularAgentReferentBlock, buildGranularAgentSessionBlock, buildGranularAgentSystemPrompt, buildGranularAgentToolBlock, buildGranularAgentWorkflowBlock, createHarnessVerifierSnapshot, evaluateContinuation, getCurrentClosureId, getExclusivePromptTarget, hasOpenPrompt, projectConversationReferentFocus, projectConversationReferentSummary, projectHeapSummary, projectLoopSummary, projectWorkflowFocus, projectWorkflowSummary, reviewGeneratedJobCode } from './agent-harness.mjs';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-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 './client-CTH1hfwe.js';
-export { ba as APIError, A as AccessTokenProvider, y as Assignment, z as AssignmentListResponse, X as Build, Z as BuildListResponse, B as BuildPolicy, Q as BuildStatus, C as ConnectOptions, aq as ConversationAppendResult, ap as ConversationMessageInput, ao as ConversationMessageShowRefs, q as ConversationSessionInfo, J as CreateEnvironmentData, w as CreatePermissionProfileData, s as CreateSandboxData, p as CreateSessionOptions, aF as DefineRelationshipOptions, bb as DeleteResponse, D as DomainState, ad as EffectHandler, aa as EffectInfo, a5 as EffectInvocationMetadata, a4 as EffectInvocationMode, a6 as EffectSchema, a7 as EffectWithHandler, ac as EffectsChangedEvent, e as Environment, H as EnvironmentData, al as EnvironmentFeedbackRecord, K as EnvironmentListResponse, aP as EnvironmentRecordImportSummary, f as EnvironmentSession, G as Granular, l as GranularAuth, k as GranularOptions, b9 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, L as Manifest, a$ as ManifestApprovalRequiredSpec, b8 as ManifestContent, aZ as ManifestDryRunSpec, b2 as ManifestEffectDeclaration, b1 as ManifestEffectSchema, aS as ManifestEnumRuleSpec, b4 as ManifestEventStreamDef, b3 as ManifestEventTypeDef, aT as ManifestFilterBySpec, b6 as ManifestImport, N as ManifestListResponse, b5 as ManifestOperation, aY as ManifestPostConditionSpec, aQ as ManifestPropertySpec, b0 as ManifestRelationshipDef, a_ as ManifestReverseSpec, aX as ManifestStateMachineSpec, aV as ManifestStateMachineStateSpec, aW as ManifestStateMachineTransitionSpec, aR as ManifestValidationOperator, aU as ManifestValidationRuleSpec, b7 as ManifestVolume, aD as ModelRef, O as OntologyHandle, o as OpenEnvironmentOptions, v as PermissionProfile, x as PermissionProfileListResponse, u as PermissionRules, a8 as PublishEffectsResult, i as PublishToolsResult, ax as RPCRequest, aA as RPCRequestFromServer, ay as RPCResponse, aO as RecordImport, aN as RecordImportItem, aL as RecordImportItemStatus, aM as RecordImportStats, aK as RecordImportStatus, aG as RecordObjectOptions, aH as RecordObjectResult, aI as RecordObjectsChunkInfo, aJ as RecordObjectsOptions, m as RecordUserOptions, aE as RelationshipInfo, a3 as ResolvedEffectApprovalRequired, a1 as ResolvedEffectDryRun, a0 as ResolvedEffectPostCondition, a2 as ResolvedEffectReverse, r as Sandbox, t as SandboxListResponse, $ as SemanticVersionDiff, _ as SemanticVersionDiffEntry, g as Session, ar as SessionHeapFieldType, as as SessionHeapFieldValue, at as SessionHeapVariable, bc as StreamEvent, be as StreamStats, bd as StreamSubscription, n as Subject, az as SyncMessage, j as ToolHandler, a9 as ToolInfo, aB as ToolInvokeParams, aC as ToolResultParams, h as ToolSchema, ab as ToolsChangedEvent, U as User, Y as Version, F as VersionTag, V as VersionTracking, W as WSClient, aw as WSClientOptions, au as WSDisconnectInfo, av as WSReconnectErrorInfo } from './client-CTH1hfwe.js';
+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 './client-C2Gk641P.js';
+export { ba as APIError, A as AccessTokenProvider, y as Assignment, z as AssignmentListResponse, X as Build, Z as BuildListResponse, B as BuildPolicy, Q as BuildStatus, C as ConnectOptions, aq as ConversationAppendResult, ap as ConversationMessageInput, ao as ConversationMessageShowRefs, q as ConversationSessionInfo, J as CreateEnvironmentData, w as CreatePermissionProfileData, s as CreateSandboxData, p as CreateSessionOptions, aF as DefineRelationshipOptions, bb as DeleteResponse, D as DomainState, ad as EffectHandler, aa as EffectInfo, a5 as EffectInvocationMetadata, a4 as EffectInvocationMode, a6 as EffectSchema, a7 as EffectWithHandler, ac as EffectsChangedEvent, e as Environment, H as EnvironmentData, al as EnvironmentFeedbackRecord, K as EnvironmentListResponse, aP as EnvironmentRecordImportSummary, f as EnvironmentSession, G as Granular, l as GranularAuth, k as GranularOptions, b9 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, L as Manifest, a$ as ManifestApprovalRequiredSpec, b8 as ManifestContent, aZ as ManifestDryRunSpec, b2 as ManifestEffectDeclaration, b1 as ManifestEffectSchema, aS as ManifestEnumRuleSpec, b4 as ManifestEventStreamDef, b3 as ManifestEventTypeDef, aT as ManifestFilterBySpec, b6 as ManifestImport, N as ManifestListResponse, b5 as ManifestOperation, aY as ManifestPostConditionSpec, aQ as ManifestPropertySpec, b0 as ManifestRelationshipDef, a_ as ManifestReverseSpec, aX as ManifestStateMachineSpec, aV as ManifestStateMachineStateSpec, aW as ManifestStateMachineTransitionSpec, aR as ManifestValidationOperator, aU as ManifestValidationRuleSpec, b7 as ManifestVolume, aD as ModelRef, O as OntologyHandle, o as OpenEnvironmentOptions, v as PermissionProfile, x as PermissionProfileListResponse, u as PermissionRules, a8 as PublishEffectsResult, i as PublishToolsResult, ax as RPCRequest, aA as RPCRequestFromServer, ay as RPCResponse, aO as RecordImport, aN as RecordImportItem, aL as RecordImportItemStatus, aM as RecordImportStats, aK as RecordImportStatus, aG as RecordObjectOptions, aH as RecordObjectResult, aI as RecordObjectsChunkInfo, aJ as RecordObjectsOptions, m as RecordUserOptions, aE as RelationshipInfo, a3 as ResolvedEffectApprovalRequired, a1 as ResolvedEffectDryRun, a0 as ResolvedEffectPostCondition, a2 as ResolvedEffectReverse, r as Sandbox, t as SandboxListResponse, $ as SemanticVersionDiff, _ as SemanticVersionDiffEntry, g as Session, ar as SessionHeapFieldType, as as SessionHeapFieldValue, at as SessionHeapVariable, bc as StreamEvent, be as StreamStats, bd as StreamSubscription, n as Subject, az as SyncMessage, j as ToolHandler, a9 as ToolInfo, aB as ToolInvokeParams, aC as ToolResultParams, h as ToolSchema, ab as ToolsChangedEvent, U as User, Y as Version, F as VersionTag, V as VersionTracking, W as WSClient, aw as WSClientOptions, au as WSDisconnectInfo, av as WSReconnectErrorInfo } from './client-C2Gk641P.js';
 export { BuildGranularAgentSystemPromptInput, GeneratedJobCodeIssue, GranularAgentExecutionCheckpoint, GranularAgentHeapSummaryOptions, GranularAgentReferentFocus, GranularAgentSessionContext, GranularAgentToolInfo, GranularAgentWorkflowFocus, HarnessContinuationDecision, HarnessControllerBudgets, HarnessProjectionOptions, HarnessPromptLike, HarnessVerifierSnapshot, HarnessVerifierSnapshotInput, buildContinuationInstruction, buildGranularAgentCheckpointBlock, buildGranularAgentDomainBlock, buildGranularAgentHeapBlock, buildGranularAgentLoopBlock, buildGranularAgentReferentBlock, buildGranularAgentSessionBlock, buildGranularAgentSystemPrompt, buildGranularAgentToolBlock, buildGranularAgentWorkflowBlock, createHarnessVerifierSnapshot, evaluateContinuation, getCurrentClosureId, getExclusivePromptTarget, hasOpenPrompt, projectConversationReferentFocus, projectConversationReferentSummary, projectHeapSummary, projectLoopSummary, projectWorkflowFocus, projectWorkflowSummary, reviewGeneratedJobCode } from './agent-harness.js';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';

package/dist/index.js

@@ -4005,7 +4005,11 @@ var WSClient = class {
       return null;
     }
     try {
-      const payloadRaw = this.decodeBase64Url(parts[1]);
+      const payloadSegment = parts[1];
+      if (!payloadSegment) {
+        return null;
+      }
+      const payloadRaw = this.decodeBase64Url(payloadSegment);
       const payload = JSON.parse(payloadRaw);
       if (typeof payload.exp !== "number" || !Number.isFinite(payload.exp)) {
         return null;
@@ -5082,6 +5086,7 @@ import { ${allImports} } from "./sandbox-tools";
       this.eventListeners.set(event, []);
     }
     this.eventListeners.get(event).push(handler);
+    return () => this.off(event, handler);
   }
   /**
    * Unsubscribe from session events
@@ -5538,6 +5543,16 @@ var JobImplementation = class {
         handler(message);
       }
     }
+    return () => {
+      const handlers = this.eventListeners.get(event);
+      if (!handlers) {
+        return;
+      }
+      this.eventListeners.set(
+        event,
+        handlers.filter((current) => current !== handler)
+      );
+    };
   }
   replayAgentMessage(message) {
     this.captureAgentMessage(message);
@@ -12084,7 +12099,9 @@ var Environment = class {
       }
     );
     if (result.errors?.length) {
-      throw new Error(`defineRelationship failed: ${result.errors[0].message}`);
+      throw new Error(
+        `defineRelationship failed: ${result.errors[0]?.message ?? "Unknown GraphQL error"}`
+      );
     }
     return result.data.at.define_relationship;
   }
@@ -12120,7 +12137,9 @@ var Environment = class {
       { path: modelPath }
     );
     if (result.errors?.length) {
-      throw new Error(`getRelationships failed: ${result.errors[0].message}`);
+      throw new Error(
+        `getRelationships failed: ${result.errors[0]?.message ?? "Unknown GraphQL error"}`
+      );
     }
     return result.data?.model?.relationships || [];
   }
@@ -12159,7 +12178,7 @@ var Environment = class {
       { target: targetPath }
     );
     if (result.errors?.length) {
-      throw new Error(`attach failed: ${result.errors[0].message}`);
+      throw new Error(`attach failed: ${result.errors[0]?.message ?? "Unknown GraphQL error"}`);
     }
   }
   /**
@@ -12194,7 +12213,7 @@ var Environment = class {
             }`
     );
     if (result.errors?.length) {
-      throw new Error(`detach failed: ${result.errors[0].message}`);
+      throw new Error(`detach failed: ${result.errors[0]?.message ?? "Unknown GraphQL error"}`);
     }
   }
   /**
@@ -12221,7 +12240,9 @@ var Environment = class {
             }`
     );
     if (result.errors?.length) {
-      throw new Error(`listRelated failed: ${result.errors[0].message}`);
+      throw new Error(
+        `listRelated failed: ${result.errors[0]?.message ?? "Unknown GraphQL error"}`
+      );
     }
     return result.data?.at?.at?.list_related || [];
   }
@@ -12314,7 +12335,7 @@ var Environment = class {
   async _runGraphql(query, label) {
     const result = await this.graphql(query);
     if (result.errors?.length) {
-      throw new Error(`${label}: ${result.errors[0].message}`);
+      throw new Error(`${label}: ${result.errors[0]?.message ?? "Unknown GraphQL error"}`);
     }
     return result.data;
   }
@@ -12659,7 +12680,11 @@ var Environment = class {
    */
   async recordObject(options) {
     const results = await this.recordObjects([options]);
-    return results[0];
+    const result = results[0];
+    if (!result) {
+      throw new Error("recordObject: no result returned for record");
+    }
+    return result;
   }
   /**
    * Batch version of `recordObject()`.
@@ -12711,7 +12736,13 @@ var Environment = class {
             );
           }
           for (let index = 0; index < items.length; index += 1) {
-            results[plan.offset + index] = items[index];
+            const item = items[index];
+            if (!item) {
+              throw new Error(
+                `recordObjects: chunk ${plan.chunkIndex + 1} returned an empty result at index ${index}`
+              );
+            }
+            results[plan.offset + index] = item;
           }
           if (onChunk) {
             const info = {