@granular-software/sdk 0.4.34 → 0.4.35

package/dist/cli/index.js

@@ -20304,6 +20304,38 @@ function normalizeUser(user) {
     permissions: Array.isArray(user.permissions) ? user.permissions : []
   };
 }
+function normalizeEnvironmentSetupSummary(setup) {
+  if (!setup) {
+    return null;
+  }
+  const queuedRecords = Number(setup.queuedRecords || 0);
+  const processingRecords = Number(setup.processingRecords || 0);
+  return {
+    ...setup,
+    setupRunId: String(setup.setupRunId || ""),
+    environmentId: String(setup.environmentId || ""),
+    sandboxId: String(setup.sandboxId || ""),
+    subjectId: String(setup.subjectId || ""),
+    triggerReason: setup.triggerReason === "fresh_after_version_update" ? "fresh_after_version_update" : "new_environment",
+    lifecycleStatus: setup.lifecycleStatus === "completed" || setup.lifecycleStatus === "failed" ? setup.lifecycleStatus : "running",
+    stage: typeof setup.stage === "string" ? setup.stage : null,
+    totalObjectsToImport: Number(setup.totalObjectsToImport || 0),
+    totalImports: Number(setup.totalImports || 0),
+    activeImports: Number(setup.activeImports || 0),
+    totalRecords: Number(setup.totalRecords || 0),
+    queuedRecords,
+    processingRecords,
+    completedRecords: Number(setup.completedRecords || 0),
+    failedRecords: Number(setup.failedRecords || 0),
+    canceledRecords: Number(setup.canceledRecords || 0),
+    awaitingRecords: Number(setup.awaitingRecords || 0) || queuedRecords + processingRecords,
+    errorMessage: typeof setup.errorMessage === "string" ? setup.errorMessage : null,
+    startedAt: Number(setup.startedAt || Date.now()),
+    hookCompletedAt: setup.hookCompletedAt == null ? null : Number(setup.hookCompletedAt),
+    finishedAt: setup.finishedAt == null ? null : Number(setup.finishedAt),
+    updatedAt: Number(setup.updatedAt || Date.now())
+  };
+}
 function normalizeEnvironmentData(environment) {
   const buildPolicy = environment.buildPolicy || environment.tracking || (environment.tagId ? { mode: "tag", tagId: environment.tagId } : {
     mode: "pinned",
@@ -20317,7 +20349,8 @@ function normalizeEnvironmentData(environment) {
     envName: environmentName,
     environment: environmentName,
     buildPolicy,
-    tracking: environment.tracking || buildPolicy
+    tracking: environment.tracking || buildPolicy,
+    setup: normalizeEnvironmentSetupSummary(environment.setup)
   };
 }
 var Environment = class {
@@ -20375,6 +20408,10 @@ var Environment = class {
   get updateState() {
     return this.envData.updateState;
   }
+  /** The latest setup/import run summary for this environment, when available. */
+  get setup() {
+    return this.envData.setup || null;
+  }
   /** Convenience flag for whether this environment trails the current tag target */
   get isOutdated() {
     return this.envData.updateState === "update_available";
@@ -20395,6 +20432,9 @@ var Environment = class {
   get runtimeBaseUrl() {
     return this.getRuntimeBaseUrl();
   }
+  syncEnvironmentData(envData) {
+    this.envData = normalizeEnvironmentData(envData);
+  }
   get sessions() {
     return {
       list: async (options) => this.listSessions(options?.status || "active"),
@@ -21340,7 +21380,8 @@ var Environment = class {
         method: "POST",
         body: JSON.stringify({
           records,
-          batchSize: options.batchSize
+          batchSize: options.batchSize,
+          setupRunId: options.setupRunId
         })
       }
     );
@@ -21488,18 +21529,12 @@ var EnvironmentSession = class extends Session {
   }
   get messages() {
     return {
-      list: (options = {}) => this.sessionDataRequest(
-        "/messages",
-        options
-      )
+      list: (options = {}) => this.sessionDataRequest("/messages", options)
     };
   }
   get timeline() {
     return {
-      list: (options = {}) => this.sessionDataRequest(
-        "/timeline",
-        options
-      )
+      list: (options = {}) => this.sessionDataRequest("/timeline", options)
     };
   }
   get jobs() {
@@ -21516,10 +21551,7 @@ var EnvironmentSession = class extends Session {
   get heap() {
     return {
       entries: {
-        list: (options = {}) => this.sessionDataRequest(
-          "/heap/entries",
-          options
-        ),
+        list: (options = {}) => this.sessionDataRequest("/heap/entries", options),
         get: (path6) => this.sessionDataRequest(
           `/heap/entries/${encodeURIComponent(path6)}`
         )
@@ -21563,10 +21595,7 @@ var EnvironmentSession = class extends Session {
         const heap = normalizeHeapSnapshot({
           entriesByPath: Object.fromEntries(
             entries.map((entry) => {
-              return entry?.path ? [
-                entry.path,
-                entry
-              ] : null;
+              return entry?.path ? [entry.path, entry] : null;
             }).filter(
               (entry) => Boolean(entry)
             )
@@ -21732,6 +21761,15 @@ var OntologyHandle = class {
       disconnect: async () => this.granular.disconnectEffects(this.ontologyNameOrId)
     };
   }
+  get importer() {
+    return {
+      onEnvironmentCreate: (handler) => this.granular.registerEnvironmentImporter(
+        this.ontologyNameOrId,
+        handler
+      ),
+      clear: () => this.granular.clearEnvironmentImporter(this.ontologyNameOrId)
+    };
+  }
 };
 var Granular = class _Granular {
   apiKey;
@@ -21748,6 +21786,10 @@ var Granular = class _Granular {
   sandboxEffectHosts = /* @__PURE__ */ new Map();
   /** In-flight host connection promises to avoid duplicate concurrent connects */
   sandboxEffectHostPromises = /* @__PURE__ */ new Map();
+  /** Ontology-bound environment importer hooks keyed by the caller's ontology identifier. */
+  ontologyImporters = /* @__PURE__ */ new Map();
+  /** Resolved importer hooks keyed by sandboxId for fast lookups during openEnvironment(). */
+  sandboxImporters = /* @__PURE__ */ new Map();
   /**
    * Create a new Granular client
    * @param options - Client configuration
@@ -21773,6 +21815,18 @@ var Granular = class _Granular {
   ontology(ontologyNameOrId) {
     return new OntologyHandle(this, ontologyNameOrId);
   }
+  registerEnvironmentImporter(ontologyNameOrId, handler) {
+    this.ontologyImporters.set(ontologyNameOrId, handler);
+    if (ontologyNameOrId.startsWith("sbx_")) {
+      this.sandboxImporters.set(ontologyNameOrId, handler);
+    }
+  }
+  clearEnvironmentImporter(ontologyNameOrId) {
+    this.ontologyImporters.delete(ontologyNameOrId);
+    if (ontologyNameOrId.startsWith("sbx_")) {
+      this.sandboxImporters.delete(ontologyNameOrId);
+    }
+  }
   /**
    * Records/upserts a user and prepares them for sandbox connections
    *
@@ -21889,11 +21943,13 @@ var Granular = class _Granular {
    * ```
    */
   async openEnvironment(options) {
-    const envData = await this.resolveOpenEnvironmentData(
+    const resolved = await this.resolveOpenEnvironmentData(
       options,
       "openEnvironment"
     );
-    return this.bindEnvironmentHandle(envData);
+    const environment = this.bindEnvironmentHandle(resolved.environment);
+    await this.maybeRunEnvironmentImporter(resolved, environment);
+    return environment;
   }
   /**
    * Deprecated compatibility alias for `openEnvironment()`.
@@ -21980,7 +22036,12 @@ var Granular = class _Granular {
       )
     );
     if (currentMatches.length > 0) {
-      return currentMatches[0];
+      return {
+        environment: currentMatches[0],
+        requestedOntology: ontology,
+        sandboxId: sandbox.sandboxId,
+        subjectId: user.granularId
+      };
     }
     const outdatedMatches = this.sortEnvironmentsByRecency(
       userEnvironments.filter(
@@ -21988,14 +22049,25 @@ var Granular = class _Granular {
       )
     );
     if (outdatedMatches.length > 0 && options.createFreshIfOutdated !== true) {
-      return outdatedMatches[0];
+      return {
+        environment: outdatedMatches[0],
+        requestedOntology: ontology,
+        sandboxId: sandbox.sandboxId,
+        subjectId: user.granularId
+      };
     }
-    return this.environments.create(sandbox.sandboxId, {
+    return {
+      environment: await this.environments.create(sandbox.sandboxId, {
+        subjectId: user.granularId,
+        environment: this.buildManagedEnvironmentName(tagName, targetVersionId),
+        tagId: tag2.tagId,
+        permissionProfileId: null
+      }),
+      requestedOntology: ontology,
+      sandboxId: sandbox.sandboxId,
       subjectId: user.granularId,
-      environment: this.buildManagedEnvironmentName(tagName, targetVersionId),
-      tagId: tag2.tagId,
-      permissionProfileId: null
-    });
+      setupTriggerReason: outdatedMatches.length > 0 ? "fresh_after_version_update" : "new_environment"
+    };
   }
   /**
    * List active (open) sessions for an environment — each session is one agent conversation thread.
@@ -22112,6 +22184,80 @@ var Granular = class _Granular {
     });
     return this.connectSession({ sessionId, clientId: options?.clientId });
   }
+  resolveEnvironmentImporter(requestedOntology, sandboxId) {
+    const resolved = this.sandboxImporters.get(sandboxId) || this.ontologyImporters.get(requestedOntology);
+    if (resolved && !this.sandboxImporters.has(sandboxId) && this.ontologyImporters.get(requestedOntology) === resolved) {
+      this.sandboxImporters.set(sandboxId, resolved);
+    }
+    return resolved;
+  }
+  async maybeRunEnvironmentImporter(resolved, environment) {
+    if (!resolved.setupTriggerReason) {
+      return;
+    }
+    const importer = this.resolveEnvironmentImporter(
+      resolved.requestedOntology,
+      resolved.sandboxId
+    );
+    if (!importer) {
+      return;
+    }
+    const setupRun = await this.request(
+      `/control/environments/${environment.environmentId}/setup-runs`,
+      {
+        method: "POST",
+        body: JSON.stringify({
+          triggerReason: resolved.setupTriggerReason
+        })
+      }
+    );
+    const setupRunId = setupRun.setupRunId;
+    const updateSetupRun = async (patch) => {
+      await this.request(
+        `/control/environment-setup-runs/${setupRunId}`,
+        {
+          method: "PATCH",
+          body: JSON.stringify(patch)
+        }
+      );
+    };
+    const importerContext = {
+      environmentId: environment.environmentId,
+      sandboxId: environment.sandboxId,
+      subjectId: environment.subjectId,
+      reason: resolved.setupTriggerReason,
+      incrementTotalObjectsToImportCount: async (n) => {
+        const safeIncrement = Math.max(0, Math.trunc(n));
+        if (safeIncrement <= 0) {
+          return;
+        }
+        await updateSetupRun({
+          incrementTotalObjectsToImportCount: safeIncrement
+        });
+      },
+      setStage: async (stage) => {
+        await updateSetupRun({ stage });
+      },
+      importRecords: async (records, options) => environment.enqueueRecordImport(records, {
+        batchSize: options?.batchSize,
+        setupRunId
+      })
+    };
+    try {
+      await importer(importerContext);
+      await updateSetupRun({ markHookCompleted: true });
+      const refreshedEnvironment = await this.environments.get(
+        environment.environmentId
+      );
+      environment.syncEnvironmentData(refreshedEnvironment);
+    } catch (error2) {
+      await updateSetupRun({
+        status: "failed",
+        errorMessage: error2 instanceof Error ? error2.message : String(error2)
+      }).catch(() => void 0);
+      throw error2;
+    }
+  }
   bindEnvironmentHandle(envData) {
     const graphqlEndpoint = `${this.httpUrl}/orchestrator/graphql`;
     return new Environment(this, envData, this.apiKey, graphqlEndpoint);

package/dist/{client-iw76FL_8.d.mts → client-Cq8onk2D.d.mts}

@@ -313,6 +313,7 @@ interface EnvironmentData {
     tag?: VersionTag | null;
     tracking?: BuildPolicy;
     buildPolicy: BuildPolicy;
+    setup?: EnvironmentSetupSummary | null;
     updateState?: "up_to_date" | "update_available" | "upgrading" | "failed";
     createdAt: number;
     updatedAt: number;
@@ -1105,6 +1106,7 @@ interface RecordImport {
     environmentId: string;
     sandboxId: string;
     subjectId: string;
+    setupRunId?: string | null;
     status: RecordImportStatus;
     batchSize: number;
     errorMessage: string | null;
@@ -1121,6 +1123,37 @@ interface EnvironmentRecordImportSummary extends RecordImportStats {
     activeImports: number;
     updatedAt: number;
 }
+type EnvironmentSetupTriggerReason = "new_environment" | "fresh_after_version_update";
+type EnvironmentSetupLifecycleStatus = "running" | "completed" | "failed";
+interface EnvironmentSetupSummary extends RecordImportStats {
+    setupRunId: string;
+    environmentId: string;
+    sandboxId: string;
+    subjectId: string;
+    triggerReason: EnvironmentSetupTriggerReason;
+    lifecycleStatus: EnvironmentSetupLifecycleStatus;
+    stage: string | null;
+    totalObjectsToImport: number;
+    totalImports: number;
+    activeImports: number;
+    errorMessage: string | null;
+    startedAt: number;
+    hookCompletedAt: number | null;
+    finishedAt: number | null;
+    updatedAt: number;
+}
+interface EnvironmentImporterImportOptions {
+    batchSize?: number;
+}
+interface EnvironmentImporter {
+    environmentId: string;
+    sandboxId: string;
+    subjectId: string;
+    reason: EnvironmentSetupTriggerReason;
+    incrementTotalObjectsToImportCount: (n: number) => Promise<void>;
+    setStage: (stage: string | null) => Promise<void>;
+    importRecords: (records: RecordObjectOptions[], options?: EnvironmentImporterImportOptions) => Promise<RecordImport>;
+}
 /**
  * Property specification in a manifest operation
  */
@@ -1577,6 +1610,7 @@ declare class Session {
     private checkForToolChanges;
 }
 
+type EnvironmentImporterHandler = (importer: EnvironmentImporter) => Promise<void> | void;
 /**
  * Environment is the sessionless handle for one resolved ontology environment.
  *
@@ -1612,6 +1646,8 @@ declare class Environment {
     get buildPolicy(): BuildPolicy;
     /** The current update state relative to the followed tag */
     get updateState(): EnvironmentData["updateState"];
+    /** The latest setup/import run summary for this environment, when available. */
+    get setup(): EnvironmentSetupSummary | null;
     /** Convenience flag for whether this environment trails the current tag target */
     get isOutdated(): boolean;
     /** The followed tag name when this environment is tag-tracked */
@@ -1622,6 +1658,7 @@ declare class Environment {
     get authToken(): string;
     /** Base runtime URL derived from the GraphQL endpoint */
     get runtimeBaseUrl(): string;
+    syncEnvironmentData(envData: EnvironmentData): void;
     get sessions(): {
         list: (options?: {
             status?: "active" | "closed" | "all";
@@ -1926,6 +1963,7 @@ declare class Environment {
      */
     enqueueRecordImport(records: RecordObjectOptions[], options?: {
         batchSize?: number;
+        setupRunId?: string;
     }): Promise<RecordImport>;
     /**
      * List queued or completed record imports for this environment.
@@ -2081,6 +2119,10 @@ declare class OntologyHandle {
         clear: () => Promise<void>;
         disconnect: () => Promise<void>;
     };
+    get importer(): {
+        onEnvironmentCreate: (handler: EnvironmentImporterHandler) => void;
+        clear: () => void;
+    };
 }
 declare class Granular {
     private apiKey;
@@ -2097,6 +2139,10 @@ declare class Granular {
     private sandboxEffectHosts;
     /** In-flight host connection promises to avoid duplicate concurrent connects */
     private sandboxEffectHostPromises;
+    /** Ontology-bound environment importer hooks keyed by the caller's ontology identifier. */
+    private ontologyImporters;
+    /** Resolved importer hooks keyed by sandboxId for fast lookups during openEnvironment(). */
+    private sandboxImporters;
     /**
      * Create a new Granular client
      * @param options - Client configuration
@@ -2106,6 +2152,8 @@ declare class Granular {
      * Return an ontology-scoped handle for effects and other ontology-level APIs.
      */
     ontology(ontologyNameOrId: string): OntologyHandle;
+    registerEnvironmentImporter(ontologyNameOrId: string, handler: EnvironmentImporterHandler): void;
+    clearEnvironmentImporter(ontologyNameOrId: string): void;
     /**
      * Records/upserts a user and prepares them for sandbox connections
      *
@@ -2204,6 +2252,8 @@ declare class Granular {
     reopenSession(sessionId: string, options?: {
         clientId?: string;
     }): Promise<EnvironmentSession>;
+    private resolveEnvironmentImporter;
+    private maybeRunEnvironmentImporter;
     private bindEnvironmentHandle;
     private bindWebSocketEnvironmentSession;
     private activateEnvironment;
@@ -2349,4 +2399,4 @@ declare class Granular {
     private request;
 }
 
-export { type SemanticVersionDiff as $, type AccessTokenProvider as A, type BuildPolicy as B, type ConnectOptions as C, type DomainState as D, type EndpointMode as E, type VersionTag as F, Granular as G, type EnvironmentData as H, type InstanceToolHandler as I, type CreateEnvironmentData as J, type EnvironmentListResponse as K, type Manifest as L, type ManifestEffectMetamodelSpec as M, type ManifestListResponse as N, OntologyHandle as O, type Prompt as P, type BuildStatus as Q, type ResolvedEffectBehaviors as R, type SessionHeapEntry as S, type ToolWithHandler as T, type User as U, type VersionTracking as V, WSClient as W, type Build as X, type Version as Y, type BuildListResponse as Z, type SemanticVersionDiffEntry as _, type EffectHandlerContext as a, type ManifestFilterBySpec as a$, type ResolvedEffectPostCondition as a0, type ResolvedEffectDryRun as a1, type ResolvedEffectReverse as a2, type ResolvedEffectApprovalRequired as a3, type EffectInvocationMode as a4, type EffectInvocationMetadata as a5, type EffectSchema as a6, type EffectWithHandler as a7, type PublishEffectsResult as a8, type EffectVersionSelector as a9, type SessionJobListOptions as aA, type SessionCollectionListResult as aB, type WSDisconnectInfo as aC, type WSReconnectErrorInfo as aD, type WSClientOptions as aE, type RPCRequest as aF, type RPCResponse as aG, type SyncMessage as aH, type RPCRequestFromServer as aI, type ToolInvokeParams as aJ, type ToolResultParams as aK, type ModelRef as aL, type RelationshipInfo as aM, type DefineRelationshipOptions as aN, type RecordObjectOptions as aO, type RecordObjectResult as aP, type RecordObjectsChunkInfo as aQ, type RecordObjectsOptions as aR, type RecordImportStatus as aS, type RecordImportItemStatus as aT, type RecordImportStats as aU, type RecordImportItem as aV, type RecordImport as aW, type EnvironmentRecordImportSummary as aX, type ManifestPropertySpec as aY, type ManifestValidationOperator as aZ, type ManifestEnumRuleSpec as a_, type ToolInfo as aa, type EffectInfo as ab, type ToolsChangedEvent as ac, type EffectsChangedEvent as ad, type EffectHandler as ae, type InstanceEffectHandler as af, type JobStatus as ag, type JobFeedbackSentiment as ah, type JobFeedbackToolCall as ai, type JobFeedbackMetadata as aj, type JobFeedbackInput as ak, type JobFeedbackRecord as al, type EnvironmentFeedbackRecord as am, type JobSubmitResult as an, type Job as ao, type ConversationMessageShowRefs as ap, type ConversationMessageInput as aq, type ConversationAppendResult as ar, type SessionConversationMessage as as, type SessionTimelineEvent as at, type SessionJobRecord as au, type SessionHeapFieldType as av, type SessionHeapFieldValue as aw, type SessionHeapVariable as ax, type SessionDocumentResult as ay, type SessionCollectionListOptions as az, type SessionHeapList as b, type ManifestValidationRuleSpec as b0, type ManifestStateMachineStateSpec as b1, type ManifestStateMachineTransitionSpec as b2, type ManifestStateMachineSpec as b3, type ManifestPostConditionSpec as b4, type ManifestDryRunSpec as b5, type ManifestReverseSpec as b6, type ManifestApprovalRequiredSpec as b7, type ManifestRelationshipDef as b8, type ManifestEffectSchema as b9, type ManifestEffectDeclaration as ba, type ManifestEventTypeDef as bb, type ManifestEventStreamDef as bc, type ManifestOperation as bd, type ManifestImport as be, type ManifestVolume as bf, type ManifestContent as bg, type GraphQLResult as bh, type APIError as bi, type DeleteResponse as bj, type StreamEvent as bk, type StreamSubscription as bl, type StreamStats as bm, type SessionHeapSnapshot as c, type SessionTranscriptEntry as d, Environment as e, EnvironmentSession as f, Session as g, type ToolSchema as h, type PublishToolsResult as i, type ToolHandler as j, type GranularOptions as k, type GranularAuth as l, type RecordUserOptions as m, type Subject as n, type OpenEnvironmentOptions as o, type CreateSessionOptions as p, type ConversationSessionInfo as q, type Sandbox as r, type CreateSandboxData as s, type SandboxListResponse as t, type PermissionRules as u, type PermissionProfile as v, type CreatePermissionProfileData as w, type PermissionProfileListResponse as x, type Assignment as y, type AssignmentListResponse as z };
+export { type SemanticVersionDiff as $, type AccessTokenProvider as A, type BuildPolicy as B, type ConnectOptions as C, type DomainState as D, type EndpointMode as E, type VersionTag as F, Granular as G, type EnvironmentData as H, type InstanceToolHandler as I, type CreateEnvironmentData as J, type EnvironmentListResponse as K, type Manifest as L, type ManifestEffectMetamodelSpec as M, type ManifestListResponse as N, OntologyHandle as O, type Prompt as P, type BuildStatus as Q, type ResolvedEffectBehaviors as R, type SessionHeapEntry as S, type ToolWithHandler as T, type User as U, type VersionTracking as V, WSClient as W, type Build as X, type Version as Y, type BuildListResponse as Z, type SemanticVersionDiffEntry as _, type EffectHandlerContext as a, type EnvironmentImporterImportOptions as a$, type ResolvedEffectPostCondition as a0, type ResolvedEffectDryRun as a1, type ResolvedEffectReverse as a2, type ResolvedEffectApprovalRequired as a3, type EffectInvocationMode as a4, type EffectInvocationMetadata as a5, type EffectSchema as a6, type EffectWithHandler as a7, type PublishEffectsResult as a8, type EffectVersionSelector as a9, type SessionJobListOptions as aA, type SessionCollectionListResult as aB, type WSDisconnectInfo as aC, type WSReconnectErrorInfo as aD, type WSClientOptions as aE, type RPCRequest as aF, type RPCResponse as aG, type SyncMessage as aH, type RPCRequestFromServer as aI, type ToolInvokeParams as aJ, type ToolResultParams as aK, type ModelRef as aL, type RelationshipInfo as aM, type DefineRelationshipOptions as aN, type RecordObjectOptions as aO, type RecordObjectResult as aP, type RecordObjectsChunkInfo as aQ, type RecordObjectsOptions as aR, type RecordImportStatus as aS, type RecordImportItemStatus as aT, type RecordImportStats as aU, type RecordImportItem as aV, type RecordImport as aW, type EnvironmentRecordImportSummary as aX, type EnvironmentSetupTriggerReason as aY, type EnvironmentSetupLifecycleStatus as aZ, type EnvironmentSetupSummary as a_, type ToolInfo as aa, type EffectInfo as ab, type ToolsChangedEvent as ac, type EffectsChangedEvent as ad, type EffectHandler as ae, type InstanceEffectHandler as af, type JobStatus as ag, type JobFeedbackSentiment as ah, type JobFeedbackToolCall as ai, type JobFeedbackMetadata as aj, type JobFeedbackInput as ak, type JobFeedbackRecord as al, type EnvironmentFeedbackRecord as am, type JobSubmitResult as an, type Job as ao, type ConversationMessageShowRefs as ap, type ConversationMessageInput as aq, type ConversationAppendResult as ar, type SessionConversationMessage as as, type SessionTimelineEvent as at, type SessionJobRecord as au, type SessionHeapFieldType as av, type SessionHeapFieldValue as aw, type SessionHeapVariable as ax, type SessionDocumentResult as ay, type SessionCollectionListOptions as az, type SessionHeapList as b, type EnvironmentImporter as b0, type ManifestPropertySpec as b1, type ManifestValidationOperator as b2, type ManifestEnumRuleSpec as b3, type ManifestFilterBySpec as b4, type ManifestValidationRuleSpec as b5, type ManifestStateMachineStateSpec as b6, type ManifestStateMachineTransitionSpec as b7, type ManifestStateMachineSpec as b8, type ManifestPostConditionSpec as b9, type ManifestDryRunSpec as ba, type ManifestReverseSpec as bb, type ManifestApprovalRequiredSpec as bc, type ManifestRelationshipDef as bd, type ManifestEffectSchema as be, type ManifestEffectDeclaration as bf, type ManifestEventTypeDef as bg, type ManifestEventStreamDef as bh, type ManifestOperation as bi, type ManifestImport as bj, type ManifestVolume as bk, type ManifestContent as bl, type GraphQLResult as bm, type APIError as bn, type DeleteResponse as bo, type StreamEvent as bp, type StreamSubscription as bq, type StreamStats as br, type SessionHeapSnapshot as c, type SessionTranscriptEntry as d, Environment as e, EnvironmentSession as f, Session as g, type ToolSchema as h, type PublishToolsResult as i, type ToolHandler as j, type GranularOptions as k, type GranularAuth as l, type RecordUserOptions as m, type Subject as n, type OpenEnvironmentOptions as o, type CreateSessionOptions as p, type ConversationSessionInfo as q, type Sandbox as r, type CreateSandboxData as s, type SandboxListResponse as t, type PermissionRules as u, type PermissionProfile as v, type CreatePermissionProfileData as w, type PermissionProfileListResponse as x, type Assignment as y, type AssignmentListResponse as z };

package/dist/{client-iw76FL_8.d.ts → client-Cq8onk2D.d.ts}

@@ -313,6 +313,7 @@ interface EnvironmentData {
     tag?: VersionTag | null;
     tracking?: BuildPolicy;
     buildPolicy: BuildPolicy;
+    setup?: EnvironmentSetupSummary | null;
     updateState?: "up_to_date" | "update_available" | "upgrading" | "failed";
     createdAt: number;
     updatedAt: number;
@@ -1105,6 +1106,7 @@ interface RecordImport {
     environmentId: string;
     sandboxId: string;
     subjectId: string;
+    setupRunId?: string | null;
     status: RecordImportStatus;
     batchSize: number;
     errorMessage: string | null;
@@ -1121,6 +1123,37 @@ interface EnvironmentRecordImportSummary extends RecordImportStats {
     activeImports: number;
     updatedAt: number;
 }
+type EnvironmentSetupTriggerReason = "new_environment" | "fresh_after_version_update";
+type EnvironmentSetupLifecycleStatus = "running" | "completed" | "failed";
+interface EnvironmentSetupSummary extends RecordImportStats {
+    setupRunId: string;
+    environmentId: string;
+    sandboxId: string;
+    subjectId: string;
+    triggerReason: EnvironmentSetupTriggerReason;
+    lifecycleStatus: EnvironmentSetupLifecycleStatus;
+    stage: string | null;
+    totalObjectsToImport: number;
+    totalImports: number;
+    activeImports: number;
+    errorMessage: string | null;
+    startedAt: number;
+    hookCompletedAt: number | null;
+    finishedAt: number | null;
+    updatedAt: number;
+}
+interface EnvironmentImporterImportOptions {
+    batchSize?: number;
+}
+interface EnvironmentImporter {
+    environmentId: string;
+    sandboxId: string;
+    subjectId: string;
+    reason: EnvironmentSetupTriggerReason;
+    incrementTotalObjectsToImportCount: (n: number) => Promise<void>;
+    setStage: (stage: string | null) => Promise<void>;
+    importRecords: (records: RecordObjectOptions[], options?: EnvironmentImporterImportOptions) => Promise<RecordImport>;
+}
 /**
  * Property specification in a manifest operation
  */
@@ -1577,6 +1610,7 @@ declare class Session {
     private checkForToolChanges;
 }
 
+type EnvironmentImporterHandler = (importer: EnvironmentImporter) => Promise<void> | void;
 /**
  * Environment is the sessionless handle for one resolved ontology environment.
  *
@@ -1612,6 +1646,8 @@ declare class Environment {
     get buildPolicy(): BuildPolicy;
     /** The current update state relative to the followed tag */
     get updateState(): EnvironmentData["updateState"];
+    /** The latest setup/import run summary for this environment, when available. */
+    get setup(): EnvironmentSetupSummary | null;
     /** Convenience flag for whether this environment trails the current tag target */
     get isOutdated(): boolean;
     /** The followed tag name when this environment is tag-tracked */
@@ -1622,6 +1658,7 @@ declare class Environment {
     get authToken(): string;
     /** Base runtime URL derived from the GraphQL endpoint */
     get runtimeBaseUrl(): string;
+    syncEnvironmentData(envData: EnvironmentData): void;
     get sessions(): {
         list: (options?: {
             status?: "active" | "closed" | "all";
@@ -1926,6 +1963,7 @@ declare class Environment {
      */
     enqueueRecordImport(records: RecordObjectOptions[], options?: {
         batchSize?: number;
+        setupRunId?: string;
     }): Promise<RecordImport>;
     /**
      * List queued or completed record imports for this environment.
@@ -2081,6 +2119,10 @@ declare class OntologyHandle {
         clear: () => Promise<void>;
         disconnect: () => Promise<void>;
     };
+    get importer(): {
+        onEnvironmentCreate: (handler: EnvironmentImporterHandler) => void;
+        clear: () => void;
+    };
 }
 declare class Granular {
     private apiKey;
@@ -2097,6 +2139,10 @@ declare class Granular {
     private sandboxEffectHosts;
     /** In-flight host connection promises to avoid duplicate concurrent connects */
     private sandboxEffectHostPromises;
+    /** Ontology-bound environment importer hooks keyed by the caller's ontology identifier. */
+    private ontologyImporters;
+    /** Resolved importer hooks keyed by sandboxId for fast lookups during openEnvironment(). */
+    private sandboxImporters;
     /**
      * Create a new Granular client
      * @param options - Client configuration
@@ -2106,6 +2152,8 @@ declare class Granular {
      * Return an ontology-scoped handle for effects and other ontology-level APIs.
      */
     ontology(ontologyNameOrId: string): OntologyHandle;
+    registerEnvironmentImporter(ontologyNameOrId: string, handler: EnvironmentImporterHandler): void;
+    clearEnvironmentImporter(ontologyNameOrId: string): void;
     /**
      * Records/upserts a user and prepares them for sandbox connections
      *
@@ -2204,6 +2252,8 @@ declare class Granular {
     reopenSession(sessionId: string, options?: {
         clientId?: string;
     }): Promise<EnvironmentSession>;
+    private resolveEnvironmentImporter;
+    private maybeRunEnvironmentImporter;
     private bindEnvironmentHandle;
     private bindWebSocketEnvironmentSession;
     private activateEnvironment;
@@ -2349,4 +2399,4 @@ declare class Granular {
     private request;
 }
 
-export { type SemanticVersionDiff as $, type AccessTokenProvider as A, type BuildPolicy as B, type ConnectOptions as C, type DomainState as D, type EndpointMode as E, type VersionTag as F, Granular as G, type EnvironmentData as H, type InstanceToolHandler as I, type CreateEnvironmentData as J, type EnvironmentListResponse as K, type Manifest as L, type ManifestEffectMetamodelSpec as M, type ManifestListResponse as N, OntologyHandle as O, type Prompt as P, type BuildStatus as Q, type ResolvedEffectBehaviors as R, type SessionHeapEntry as S, type ToolWithHandler as T, type User as U, type VersionTracking as V, WSClient as W, type Build as X, type Version as Y, type BuildListResponse as Z, type SemanticVersionDiffEntry as _, type EffectHandlerContext as a, type ManifestFilterBySpec as a$, type ResolvedEffectPostCondition as a0, type ResolvedEffectDryRun as a1, type ResolvedEffectReverse as a2, type ResolvedEffectApprovalRequired as a3, type EffectInvocationMode as a4, type EffectInvocationMetadata as a5, type EffectSchema as a6, type EffectWithHandler as a7, type PublishEffectsResult as a8, type EffectVersionSelector as a9, type SessionJobListOptions as aA, type SessionCollectionListResult as aB, type WSDisconnectInfo as aC, type WSReconnectErrorInfo as aD, type WSClientOptions as aE, type RPCRequest as aF, type RPCResponse as aG, type SyncMessage as aH, type RPCRequestFromServer as aI, type ToolInvokeParams as aJ, type ToolResultParams as aK, type ModelRef as aL, type RelationshipInfo as aM, type DefineRelationshipOptions as aN, type RecordObjectOptions as aO, type RecordObjectResult as aP, type RecordObjectsChunkInfo as aQ, type RecordObjectsOptions as aR, type RecordImportStatus as aS, type RecordImportItemStatus as aT, type RecordImportStats as aU, type RecordImportItem as aV, type RecordImport as aW, type EnvironmentRecordImportSummary as aX, type ManifestPropertySpec as aY, type ManifestValidationOperator as aZ, type ManifestEnumRuleSpec as a_, type ToolInfo as aa, type EffectInfo as ab, type ToolsChangedEvent as ac, type EffectsChangedEvent as ad, type EffectHandler as ae, type InstanceEffectHandler as af, type JobStatus as ag, type JobFeedbackSentiment as ah, type JobFeedbackToolCall as ai, type JobFeedbackMetadata as aj, type JobFeedbackInput as ak, type JobFeedbackRecord as al, type EnvironmentFeedbackRecord as am, type JobSubmitResult as an, type Job as ao, type ConversationMessageShowRefs as ap, type ConversationMessageInput as aq, type ConversationAppendResult as ar, type SessionConversationMessage as as, type SessionTimelineEvent as at, type SessionJobRecord as au, type SessionHeapFieldType as av, type SessionHeapFieldValue as aw, type SessionHeapVariable as ax, type SessionDocumentResult as ay, type SessionCollectionListOptions as az, type SessionHeapList as b, type ManifestValidationRuleSpec as b0, type ManifestStateMachineStateSpec as b1, type ManifestStateMachineTransitionSpec as b2, type ManifestStateMachineSpec as b3, type ManifestPostConditionSpec as b4, type ManifestDryRunSpec as b5, type ManifestReverseSpec as b6, type ManifestApprovalRequiredSpec as b7, type ManifestRelationshipDef as b8, type ManifestEffectSchema as b9, type ManifestEffectDeclaration as ba, type ManifestEventTypeDef as bb, type ManifestEventStreamDef as bc, type ManifestOperation as bd, type ManifestImport as be, type ManifestVolume as bf, type ManifestContent as bg, type GraphQLResult as bh, type APIError as bi, type DeleteResponse as bj, type StreamEvent as bk, type StreamSubscription as bl, type StreamStats as bm, type SessionHeapSnapshot as c, type SessionTranscriptEntry as d, Environment as e, EnvironmentSession as f, Session as g, type ToolSchema as h, type PublishToolsResult as i, type ToolHandler as j, type GranularOptions as k, type GranularAuth as l, type RecordUserOptions as m, type Subject as n, type OpenEnvironmentOptions as o, type CreateSessionOptions as p, type ConversationSessionInfo as q, type Sandbox as r, type CreateSandboxData as s, type SandboxListResponse as t, type PermissionRules as u, type PermissionProfile as v, type CreatePermissionProfileData as w, type PermissionProfileListResponse as x, type Assignment as y, type AssignmentListResponse as z };
+export { type SemanticVersionDiff as $, type AccessTokenProvider as A, type BuildPolicy as B, type ConnectOptions as C, type DomainState as D, type EndpointMode as E, type VersionTag as F, Granular as G, type EnvironmentData as H, type InstanceToolHandler as I, type CreateEnvironmentData as J, type EnvironmentListResponse as K, type Manifest as L, type ManifestEffectMetamodelSpec as M, type ManifestListResponse as N, OntologyHandle as O, type Prompt as P, type BuildStatus as Q, type ResolvedEffectBehaviors as R, type SessionHeapEntry as S, type ToolWithHandler as T, type User as U, type VersionTracking as V, WSClient as W, type Build as X, type Version as Y, type BuildListResponse as Z, type SemanticVersionDiffEntry as _, type EffectHandlerContext as a, type EnvironmentImporterImportOptions as a$, type ResolvedEffectPostCondition as a0, type ResolvedEffectDryRun as a1, type ResolvedEffectReverse as a2, type ResolvedEffectApprovalRequired as a3, type EffectInvocationMode as a4, type EffectInvocationMetadata as a5, type EffectSchema as a6, type EffectWithHandler as a7, type PublishEffectsResult as a8, type EffectVersionSelector as a9, type SessionJobListOptions as aA, type SessionCollectionListResult as aB, type WSDisconnectInfo as aC, type WSReconnectErrorInfo as aD, type WSClientOptions as aE, type RPCRequest as aF, type RPCResponse as aG, type SyncMessage as aH, type RPCRequestFromServer as aI, type ToolInvokeParams as aJ, type ToolResultParams as aK, type ModelRef as aL, type RelationshipInfo as aM, type DefineRelationshipOptions as aN, type RecordObjectOptions as aO, type RecordObjectResult as aP, type RecordObjectsChunkInfo as aQ, type RecordObjectsOptions as aR, type RecordImportStatus as aS, type RecordImportItemStatus as aT, type RecordImportStats as aU, type RecordImportItem as aV, type RecordImport as aW, type EnvironmentRecordImportSummary as aX, type EnvironmentSetupTriggerReason as aY, type EnvironmentSetupLifecycleStatus as aZ, type EnvironmentSetupSummary as a_, type ToolInfo as aa, type EffectInfo as ab, type ToolsChangedEvent as ac, type EffectsChangedEvent as ad, type EffectHandler as ae, type InstanceEffectHandler as af, type JobStatus as ag, type JobFeedbackSentiment as ah, type JobFeedbackToolCall as ai, type JobFeedbackMetadata as aj, type JobFeedbackInput as ak, type JobFeedbackRecord as al, type EnvironmentFeedbackRecord as am, type JobSubmitResult as an, type Job as ao, type ConversationMessageShowRefs as ap, type ConversationMessageInput as aq, type ConversationAppendResult as ar, type SessionConversationMessage as as, type SessionTimelineEvent as at, type SessionJobRecord as au, type SessionHeapFieldType as av, type SessionHeapFieldValue as aw, type SessionHeapVariable as ax, type SessionDocumentResult as ay, type SessionCollectionListOptions as az, type SessionHeapList as b, type EnvironmentImporter as b0, type ManifestPropertySpec as b1, type ManifestValidationOperator as b2, type ManifestEnumRuleSpec as b3, type ManifestFilterBySpec as b4, type ManifestValidationRuleSpec as b5, type ManifestStateMachineStateSpec as b6, type ManifestStateMachineTransitionSpec as b7, type ManifestStateMachineSpec as b8, type ManifestPostConditionSpec as b9, type ManifestDryRunSpec as ba, type ManifestReverseSpec as bb, type ManifestApprovalRequiredSpec as bc, type ManifestRelationshipDef as bd, type ManifestEffectSchema as be, type ManifestEffectDeclaration as bf, type ManifestEventTypeDef as bg, type ManifestEventStreamDef as bh, type ManifestOperation as bi, type ManifestImport as bj, type ManifestVolume as bk, type ManifestContent as bl, type GraphQLResult as bm, type APIError as bn, type DeleteResponse as bo, type StreamEvent as bp, type StreamSubscription as bq, type StreamStats as br, type SessionHeapSnapshot as c, type SessionTranscriptEntry as d, Environment as e, EnvironmentSession as f, Session as g, type ToolSchema as h, type PublishToolsResult as i, type ToolHandler as j, type GranularOptions as k, type GranularAuth as l, type RecordUserOptions as m, type Subject as n, type OpenEnvironmentOptions as o, type CreateSessionOptions as p, type ConversationSessionInfo as q, type Sandbox as r, type CreateSandboxData as s, type SandboxListResponse as t, type PermissionRules as u, type PermissionProfile as v, type CreatePermissionProfileData as w, type PermissionProfileListResponse as x, type Assignment as y, type AssignmentListResponse as z };

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-iw76FL_8.mjs';
-export { bi 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, ar as ConversationAppendResult, aq as ConversationMessageInput, ap as ConversationMessageShowRefs, q as ConversationSessionInfo, J as CreateEnvironmentData, w as CreatePermissionProfileData, s as CreateSandboxData, p as CreateSessionOptions, aN as DefineRelationshipOptions, bj as DeleteResponse, D as DomainState, ae as EffectHandler, ab as EffectInfo, a5 as EffectInvocationMetadata, a4 as EffectInvocationMode, a6 as EffectSchema, a9 as EffectVersionSelector, a7 as EffectWithHandler, ad as EffectsChangedEvent, e as Environment, H as EnvironmentData, am as EnvironmentFeedbackRecord, K as EnvironmentListResponse, aX as EnvironmentRecordImportSummary, f as EnvironmentSession, G as Granular, l as GranularAuth, k as GranularOptions, bh as GraphQLResult, af as InstanceEffectHandler, I as InstanceToolHandler, ao as Job, ak as JobFeedbackInput, aj as JobFeedbackMetadata, al as JobFeedbackRecord, ah as JobFeedbackSentiment, ai as JobFeedbackToolCall, ag as JobStatus, an as JobSubmitResult, L as Manifest, b7 as ManifestApprovalRequiredSpec, bg as ManifestContent, b5 as ManifestDryRunSpec, ba as ManifestEffectDeclaration, b9 as ManifestEffectSchema, a_ as ManifestEnumRuleSpec, bc as ManifestEventStreamDef, bb as ManifestEventTypeDef, a$ as ManifestFilterBySpec, be as ManifestImport, N as ManifestListResponse, bd as ManifestOperation, b4 as ManifestPostConditionSpec, aY as ManifestPropertySpec, b8 as ManifestRelationshipDef, b6 as ManifestReverseSpec, b3 as ManifestStateMachineSpec, b1 as ManifestStateMachineStateSpec, b2 as ManifestStateMachineTransitionSpec, aZ as ManifestValidationOperator, b0 as ManifestValidationRuleSpec, bf as ManifestVolume, aL as ModelRef, O as OntologyHandle, o as OpenEnvironmentOptions, v as PermissionProfile, x as PermissionProfileListResponse, u as PermissionRules, a8 as PublishEffectsResult, i as PublishToolsResult, aF as RPCRequest, aI as RPCRequestFromServer, aG as RPCResponse, aW as RecordImport, aV as RecordImportItem, aT as RecordImportItemStatus, aU as RecordImportStats, aS as RecordImportStatus, aO as RecordObjectOptions, aP as RecordObjectResult, aQ as RecordObjectsChunkInfo, aR as RecordObjectsOptions, m as RecordUserOptions, aM 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, az as SessionCollectionListOptions, aB as SessionCollectionListResult, as as SessionConversationMessage, ay as SessionDocumentResult, av as SessionHeapFieldType, aw as SessionHeapFieldValue, ax as SessionHeapVariable, aA as SessionJobListOptions, au as SessionJobRecord, at as SessionTimelineEvent, bk as StreamEvent, bm as StreamStats, bl as StreamSubscription, n as Subject, aH as SyncMessage, j as ToolHandler, aa as ToolInfo, aJ as ToolInvokeParams, aK as ToolResultParams, h as ToolSchema, ac as ToolsChangedEvent, U as User, Y as Version, F as VersionTag, V as VersionTracking, W as WSClient, aE as WSClientOptions, aC as WSDisconnectInfo, aD as WSReconnectErrorInfo } from './client-iw76FL_8.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-Cq8onk2D.mjs';
+export { bn 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, ar as ConversationAppendResult, aq as ConversationMessageInput, ap as ConversationMessageShowRefs, q as ConversationSessionInfo, J as CreateEnvironmentData, w as CreatePermissionProfileData, s as CreateSandboxData, p as CreateSessionOptions, aN as DefineRelationshipOptions, bo as DeleteResponse, D as DomainState, ae as EffectHandler, ab as EffectInfo, a5 as EffectInvocationMetadata, a4 as EffectInvocationMode, a6 as EffectSchema, a9 as EffectVersionSelector, a7 as EffectWithHandler, ad as EffectsChangedEvent, e as Environment, H as EnvironmentData, am as EnvironmentFeedbackRecord, b0 as EnvironmentImporter, a$ as EnvironmentImporterImportOptions, K as EnvironmentListResponse, aX as EnvironmentRecordImportSummary, f as EnvironmentSession, aZ as EnvironmentSetupLifecycleStatus, a_ as EnvironmentSetupSummary, aY as EnvironmentSetupTriggerReason, G as Granular, l as GranularAuth, k as GranularOptions, bm as GraphQLResult, af as InstanceEffectHandler, I as InstanceToolHandler, ao as Job, ak as JobFeedbackInput, aj as JobFeedbackMetadata, al as JobFeedbackRecord, ah as JobFeedbackSentiment, ai as JobFeedbackToolCall, ag as JobStatus, an as JobSubmitResult, L as Manifest, bc as ManifestApprovalRequiredSpec, bl as ManifestContent, ba as ManifestDryRunSpec, bf as ManifestEffectDeclaration, be as ManifestEffectSchema, b3 as ManifestEnumRuleSpec, bh as ManifestEventStreamDef, bg as ManifestEventTypeDef, b4 as ManifestFilterBySpec, bj as ManifestImport, N as ManifestListResponse, bi as ManifestOperation, b9 as ManifestPostConditionSpec, b1 as ManifestPropertySpec, bd as ManifestRelationshipDef, bb as ManifestReverseSpec, b8 as ManifestStateMachineSpec, b6 as ManifestStateMachineStateSpec, b7 as ManifestStateMachineTransitionSpec, b2 as ManifestValidationOperator, b5 as ManifestValidationRuleSpec, bk as ManifestVolume, aL as ModelRef, O as OntologyHandle, o as OpenEnvironmentOptions, v as PermissionProfile, x as PermissionProfileListResponse, u as PermissionRules, a8 as PublishEffectsResult, i as PublishToolsResult, aF as RPCRequest, aI as RPCRequestFromServer, aG as RPCResponse, aW as RecordImport, aV as RecordImportItem, aT as RecordImportItemStatus, aU as RecordImportStats, aS as RecordImportStatus, aO as RecordObjectOptions, aP as RecordObjectResult, aQ as RecordObjectsChunkInfo, aR as RecordObjectsOptions, m as RecordUserOptions, aM 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, az as SessionCollectionListOptions, aB as SessionCollectionListResult, as as SessionConversationMessage, ay as SessionDocumentResult, av as SessionHeapFieldType, aw as SessionHeapFieldValue, ax as SessionHeapVariable, aA as SessionJobListOptions, au as SessionJobRecord, at as SessionTimelineEvent, bp as StreamEvent, br as StreamStats, bq as StreamSubscription, n as Subject, aH as SyncMessage, j as ToolHandler, aa as ToolInfo, aJ as ToolInvokeParams, aK as ToolResultParams, h as ToolSchema, ac as ToolsChangedEvent, U as User, Y as Version, F as VersionTag, V as VersionTracking, W as WSClient, aE as WSClientOptions, aC as WSDisconnectInfo, aD as WSReconnectErrorInfo } from './client-Cq8onk2D.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-iw76FL_8.js';
-export { bi 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, ar as ConversationAppendResult, aq as ConversationMessageInput, ap as ConversationMessageShowRefs, q as ConversationSessionInfo, J as CreateEnvironmentData, w as CreatePermissionProfileData, s as CreateSandboxData, p as CreateSessionOptions, aN as DefineRelationshipOptions, bj as DeleteResponse, D as DomainState, ae as EffectHandler, ab as EffectInfo, a5 as EffectInvocationMetadata, a4 as EffectInvocationMode, a6 as EffectSchema, a9 as EffectVersionSelector, a7 as EffectWithHandler, ad as EffectsChangedEvent, e as Environment, H as EnvironmentData, am as EnvironmentFeedbackRecord, K as EnvironmentListResponse, aX as EnvironmentRecordImportSummary, f as EnvironmentSession, G as Granular, l as GranularAuth, k as GranularOptions, bh as GraphQLResult, af as InstanceEffectHandler, I as InstanceToolHandler, ao as Job, ak as JobFeedbackInput, aj as JobFeedbackMetadata, al as JobFeedbackRecord, ah as JobFeedbackSentiment, ai as JobFeedbackToolCall, ag as JobStatus, an as JobSubmitResult, L as Manifest, b7 as ManifestApprovalRequiredSpec, bg as ManifestContent, b5 as ManifestDryRunSpec, ba as ManifestEffectDeclaration, b9 as ManifestEffectSchema, a_ as ManifestEnumRuleSpec, bc as ManifestEventStreamDef, bb as ManifestEventTypeDef, a$ as ManifestFilterBySpec, be as ManifestImport, N as ManifestListResponse, bd as ManifestOperation, b4 as ManifestPostConditionSpec, aY as ManifestPropertySpec, b8 as ManifestRelationshipDef, b6 as ManifestReverseSpec, b3 as ManifestStateMachineSpec, b1 as ManifestStateMachineStateSpec, b2 as ManifestStateMachineTransitionSpec, aZ as ManifestValidationOperator, b0 as ManifestValidationRuleSpec, bf as ManifestVolume, aL as ModelRef, O as OntologyHandle, o as OpenEnvironmentOptions, v as PermissionProfile, x as PermissionProfileListResponse, u as PermissionRules, a8 as PublishEffectsResult, i as PublishToolsResult, aF as RPCRequest, aI as RPCRequestFromServer, aG as RPCResponse, aW as RecordImport, aV as RecordImportItem, aT as RecordImportItemStatus, aU as RecordImportStats, aS as RecordImportStatus, aO as RecordObjectOptions, aP as RecordObjectResult, aQ as RecordObjectsChunkInfo, aR as RecordObjectsOptions, m as RecordUserOptions, aM 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, az as SessionCollectionListOptions, aB as SessionCollectionListResult, as as SessionConversationMessage, ay as SessionDocumentResult, av as SessionHeapFieldType, aw as SessionHeapFieldValue, ax as SessionHeapVariable, aA as SessionJobListOptions, au as SessionJobRecord, at as SessionTimelineEvent, bk as StreamEvent, bm as StreamStats, bl as StreamSubscription, n as Subject, aH as SyncMessage, j as ToolHandler, aa as ToolInfo, aJ as ToolInvokeParams, aK as ToolResultParams, h as ToolSchema, ac as ToolsChangedEvent, U as User, Y as Version, F as VersionTag, V as VersionTracking, W as WSClient, aE as WSClientOptions, aC as WSDisconnectInfo, aD as WSReconnectErrorInfo } from './client-iw76FL_8.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-Cq8onk2D.js';
+export { bn 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, ar as ConversationAppendResult, aq as ConversationMessageInput, ap as ConversationMessageShowRefs, q as ConversationSessionInfo, J as CreateEnvironmentData, w as CreatePermissionProfileData, s as CreateSandboxData, p as CreateSessionOptions, aN as DefineRelationshipOptions, bo as DeleteResponse, D as DomainState, ae as EffectHandler, ab as EffectInfo, a5 as EffectInvocationMetadata, a4 as EffectInvocationMode, a6 as EffectSchema, a9 as EffectVersionSelector, a7 as EffectWithHandler, ad as EffectsChangedEvent, e as Environment, H as EnvironmentData, am as EnvironmentFeedbackRecord, b0 as EnvironmentImporter, a$ as EnvironmentImporterImportOptions, K as EnvironmentListResponse, aX as EnvironmentRecordImportSummary, f as EnvironmentSession, aZ as EnvironmentSetupLifecycleStatus, a_ as EnvironmentSetupSummary, aY as EnvironmentSetupTriggerReason, G as Granular, l as GranularAuth, k as GranularOptions, bm as GraphQLResult, af as InstanceEffectHandler, I as InstanceToolHandler, ao as Job, ak as JobFeedbackInput, aj as JobFeedbackMetadata, al as JobFeedbackRecord, ah as JobFeedbackSentiment, ai as JobFeedbackToolCall, ag as JobStatus, an as JobSubmitResult, L as Manifest, bc as ManifestApprovalRequiredSpec, bl as ManifestContent, ba as ManifestDryRunSpec, bf as ManifestEffectDeclaration, be as ManifestEffectSchema, b3 as ManifestEnumRuleSpec, bh as ManifestEventStreamDef, bg as ManifestEventTypeDef, b4 as ManifestFilterBySpec, bj as ManifestImport, N as ManifestListResponse, bi as ManifestOperation, b9 as ManifestPostConditionSpec, b1 as ManifestPropertySpec, bd as ManifestRelationshipDef, bb as ManifestReverseSpec, b8 as ManifestStateMachineSpec, b6 as ManifestStateMachineStateSpec, b7 as ManifestStateMachineTransitionSpec, b2 as ManifestValidationOperator, b5 as ManifestValidationRuleSpec, bk as ManifestVolume, aL as ModelRef, O as OntologyHandle, o as OpenEnvironmentOptions, v as PermissionProfile, x as PermissionProfileListResponse, u as PermissionRules, a8 as PublishEffectsResult, i as PublishToolsResult, aF as RPCRequest, aI as RPCRequestFromServer, aG as RPCResponse, aW as RecordImport, aV as RecordImportItem, aT as RecordImportItemStatus, aU as RecordImportStats, aS as RecordImportStatus, aO as RecordObjectOptions, aP as RecordObjectResult, aQ as RecordObjectsChunkInfo, aR as RecordObjectsOptions, m as RecordUserOptions, aM 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, az as SessionCollectionListOptions, aB as SessionCollectionListResult, as as SessionConversationMessage, ay as SessionDocumentResult, av as SessionHeapFieldType, aw as SessionHeapFieldValue, ax as SessionHeapVariable, aA as SessionJobListOptions, au as SessionJobRecord, at as SessionTimelineEvent, bp as StreamEvent, br as StreamStats, bq as StreamSubscription, n as Subject, aH as SyncMessage, j as ToolHandler, aa as ToolInfo, aJ as ToolInvokeParams, aK as ToolResultParams, h as ToolSchema, ac as ToolsChangedEvent, U as User, Y as Version, F as VersionTag, V as VersionTracking, W as WSClient, aE as WSClientOptions, aC as WSDisconnectInfo, aD as WSReconnectErrorInfo } from './client-Cq8onk2D.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';