@granular-software/sdk 0.4.58 → 0.4.60

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-export { E as Environment, a as EnvironmentSession, G as Granular, O as OntologyHandle, S as Session, W as WSClient } from './client-DFaCRSto.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-czRX7l0X.mjs';
-export { cN as APIError, A as AccessTokenProvider, J as AdoptEnvironmentOptions, bg as ArtifactApprovalDecisionInput, bh as ArtifactApprovalDecisionResult, be as ArtifactApprovalTask, bf as ArtifactApprovalTaskListOptions, bd as ArtifactApprovalTaskStatus, aa as Assignment, ab as AssignmentListResponse, al as Build, an as BuildListResponse, ac as BuildPolicy, ak as BuildStatus, C as ConditionIR, K as ConnectOptions, aV as ConversationActionSuggestion, aZ as ConversationAppendResult, aW as ConversationMessageAction, aY as ConversationMessageInput, aX as ConversationMessagePart, aP as ConversationMessageShowRefs, Q as ConversationSessionInfo, W as ConversationSessionListOptions, V as ConversationSessionListStatus, aQ as ConversationTableCell, aR as ConversationTableColumn, aU as ConversationTableProjection, aT as ConversationTableRow, aS as ConversationTableRowReference, ag as CreateEnvironmentData, a8 as CreatePermissionProfileData, a4 as CreateSandboxData, L as CreateSessionOptions, bV as DefineRelationshipOptions, cO as DeleteResponse, D as DomainState, aE as EffectHandler, aB as EffectInfo, av as EffectInvocationMetadata, au as EffectInvocationMode, aw as EffectSchema, az as EffectVersionSelector, ax as EffectWithHandler, aD as EffectsChangedEvent, af as EnvironmentData, aM as EnvironmentFeedbackRecord, ci as EnvironmentImporter, ch as EnvironmentImporterImportOptions, ah as EnvironmentListResponse, cb as EnvironmentRecordImportSummary, cg as EnvironmentSetupImporterClaim, ce as EnvironmentSetupLifecycleStatus, cf as EnvironmentSetupSummary, cc as EnvironmentSetupTriggerReason, b$ as EnvironmentStateMachineProxy, bZ as EnvironmentStateObservationInput, c0 as EnvironmentStateProxy, bY as EnvironmentStateTarget, b_ as EnvironmentStateUpdateInput, z as GranularAuth, y as GranularOptions, a1 as GranularQuotaPolicy, a2 as GranularQuotaProgress, G as GranularSpendContext, cM 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, ai as Manifest, cB as ManifestApprovalRequiredSpec, cL as ManifestContent, cC as ManifestCreatesSpec, cz as ManifestDryRunSpec, cF as ManifestEffectDeclaration, cE as ManifestEffectSchema, cl as ManifestEnumRuleSpec, cH as ManifestEventStreamDef, cG as ManifestEventTypeDef, cm as ManifestFilterBySpec, cJ as ManifestImport, aj as ManifestListResponse, cI as ManifestOperation, cy as ManifestPostConditionSpec, cj as ManifestPropertySpec, cD as ManifestRelationshipDef, cA as ManifestReverseSpec, cx as ManifestStateMachineSpec, co as ManifestStateMachineStateSpec, cw as ManifestStateMachineTransitionSpec, cq as ManifestStateTransitionActionSpec, cr as ManifestStateTransitionAssigneeSpec, cv as ManifestStateTransitionExpectedOutcomeSpec, cp as ManifestStateTransitionInputBinding, cu as ManifestStateTransitionPermissionSpec, cs as ManifestStateTransitionRelatedStateRequirementSpec, ct as ManifestStateTransitionRequirementsSpec, ck as ManifestValidationOperator, cn as ManifestValidationRuleSpec, cK as ManifestVolume, bp as ManualActionListOptions, bn as ManualActionOccurrence, bo as ManualActionRecordResult, bl as ManualActionRelatedRecord, bj as ManualActionSource, bi as ManualActionStatus, bq as ManualActionSuggestion, br as ManualActionSuggestionOptions, bk as ManualActionTarget, bJ as MarkUserEnvironmentReadOptions, x as MatchedPolicy, bT 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, a7 as PermissionProfile, a9 as PermissionProfileListResponse, a6 as PermissionRules, u as PolicyOperator, v as PolicyOrigin, s as PolicyPredicateSource, w as PolicyRuleIR, q as PolicySource, ay as PublishEffectsResult, f as PublishToolsResult, a0 as QuotaLineItemFilter, Z as QuotaPeriod, Y as QuotaScopeType, _ as QuotaStatus, bN as RPCRequest, bQ as RPCRequestFromServer, bO as RPCResponse, ca as RecordImport, c9 as RecordImportItem, c7 as RecordImportItemStatus, c5 as RecordImportOptions, c8 as RecordImportStats, c6 as RecordImportStatus, c4 as RecordImportWriteMode, bm as RecordManualActionInput, bz as RecordMentionInput, bW as RecordObjectOptions, c1 as RecordObjectResult, bX as RecordObjectStateValue, c2 as RecordObjectsChunkInfo, c3 as RecordObjectsOptions, m as RecordOpenAIUsageSpendOptions, o as RecordOpenAIUsageSpendResult, by as RecordSearchOptions, bx as RecordSearchResult, B as RecordUserOptions, bU as RelationshipInfo, at as ResolvedEffectApprovalRequired, ar as ResolvedEffectDryRun, aq as ResolvedEffectPostCondition, as as ResolvedEffectReverse, cd as RunEnvironmentImporterOptions, a3 as Sandbox, a5 as SandboxListResponse, ap as SemanticVersionDiff, ao as SemanticVersionDiffEntry, bc as SessionArtifactApprovalOptions, b6 as SessionArtifactAutonomyPolicy, bb as SessionArtifactExecutionOptions, ba as SessionArtifactExecutionResult, b5 as SessionArtifactKind, b8 as SessionArtifactListOptions, b7 as SessionArtifactRecord, b4 as SessionArtifactStatus, b9 as SessionArtifactValidationResult, bB as SessionCollectionListOptions, bD as SessionCollectionListResult, a_ as SessionConversationMessage, bA as SessionDocumentResult, b1 as SessionFileKind, b3 as SessionFileRecord, b0 as SessionFileSource, b2 as SessionFileStatus, bs as SessionFileUploadOptions, bu as SessionHeapFieldType, bv as SessionHeapFieldValue, bw as SessionHeapVariable, bC as SessionJobListOptions, bt as SessionJobRecord, a$ as SessionTimelineEvent, X as SpendLineItemType, $ as SpendSummary, cP as StreamEvent, cR as StreamStats, cQ as StreamSubscription, F as Subject, bP as SyncMessage, g as ToolHandler, aA as ToolInfo, bR as ToolInvokeParams, bS as ToolResultParams, e as ToolSchema, aC as ToolsChangedEvent, U as User, bF as UserEnvironmentMessagePreview, bE as UserEnvironmentPrompt, bG as UserEnvironmentSessionState, bH as UserEnvironmentState, bI as UserEnvironmentStateOptions, am as Version, ae as VersionTag, ad as VersionTracking, bM as WSClientOptions, bK as WSDisconnectInfo, bL as WSReconnectErrorInfo, p as buildOpenAISpendEventId, k as calculateOpenAITokenSpend, j as getOpenAIModelPricing, n as normalizeOpenAIUsage, r as recordOpenAIUsageSpend, t as toGranularHttpBase } from './spend-czRX7l0X.mjs';
+export { E as Environment, a as EnvironmentSession, G as Granular, O as OntologyHandle, S as Session, W as WSClient } from './client-DSkGcmmX.mjs';
+import { E as EndpointMode, T as ToolWithHandler, a as EffectHandlerContext, F as FeedPublishTransport, M as ManifestEffectMetamodelSpec, R as ResolvedEffectBehaviors, S as SessionHeapEntry, b as SessionHeapList, c as FeedItem, d as SessionHeapSnapshot, P as Prompt, e as SessionTranscriptEntry } from './spend-CNe-Ff6U.mjs';
+export { dP as APIError, aH as AccessTokenProvider, C as ActionSuggestionFeedItem, aO as AdoptEnvironmentOptions, ch as ArtifactApprovalDecisionInput, ci as ArtifactApprovalDecisionResult, cf as ArtifactApprovalTask, cg as ArtifactApprovalTaskListOptions, ce as ArtifactApprovalTaskStatus, A as ArtifactFeedItem, bw as ArtifactOptionsHandler, b7 as Assignment, b8 as AssignmentListResponse, bU as AssistantReplyPublicationInput, bV as AssistantReplyPublicationResult, bi as Build, bk as BuildListResponse, b9 as BuildPolicy, bh as BuildStatus, aD as ConditionIR, aP as ConnectOptions, aR as ConversationSessionInfo, aT as ConversationSessionListOptions, aS as ConversationSessionListStatus, bd as CreateEnvironmentData, b5 as CreatePermissionProfileData, b1 as CreateSandboxData, aQ as CreateSessionOptions, cW as DefineRelationshipOptions, dQ as DeleteResponse, D as DomainState, bs as EffectArtifactOptionsInvocation, bu as EffectArtifactRelationshipOption, bv as EffectArtifactRelationshipOptionsResult, bF as EffectHandler, bC as EffectInfo, bt as EffectInvocationMetadata, br as EffectInvocationMode, bx as EffectSchema, bA as EffectVersionSelector, by as EffectWithHandler, bE as EffectsChangedEvent, bc as EnvironmentData, bN as EnvironmentFeedbackRecord, dj as EnvironmentImporter, di as EnvironmentImporterImportOptions, be as EnvironmentListResponse, dc as EnvironmentRecordImportSummary, dh as EnvironmentSetupImporterClaim, df as EnvironmentSetupLifecycleStatus, dg as EnvironmentSetupSummary, dd as EnvironmentSetupTriggerReason, d0 as EnvironmentStateMachineProxy, c_ as EnvironmentStateObservationInput, d1 as EnvironmentStateProxy, cZ as EnvironmentStateTarget, c$ as EnvironmentStateUpdateInput, a1 as FeedDiagnostic, a2 as FeedDiagnosticListener, a9 as FeedDocumentState, l as FeedFeedbackTone, z as FeedFileSource, k as FeedIconToken, p as FeedItemBase, n as FeedItemKind, U as FeedListOptions, $ as FeedListTransport, s as FeedObjectReference, V as FeedPage, ak as FeedPublisher, Q as FeedSnapshot, a0 as FeedSnapshotRegressionReason, j as FeedSource, i as FeedSourceActor, W as FeedSubscribeOptions, X as FeedSubscriptionChange, t as FeedTableCell, u as FeedTableColumn, x as FeedTableProjection, w as FeedTableRow, v as FeedTableRowReference, o as FeedTarget, m as FeedTransientFeedbackTone, r as FeedbackFeedItem, B as FileFeedItem, a3 as GRANULAR_FEED_DIAGNOSTIC_EVENT, aJ as GranularAuth, aI as GranularOptions, a_ as GranularQuotaPolicy, a$ as GranularQuotaProgress, at as GranularSpendContext, dO as GraphQLResult, bG as InstanceEffectHandler, I as InstanceToolHandler, bP as Job, bL as JobFeedbackInput, bK as JobFeedbackMetadata, bM as JobFeedbackRecord, bI as JobFeedbackSentiment, bJ as JobFeedbackToolCall, bH as JobStatus, bO as JobSubmitResult, bf as Manifest, dD as ManifestApprovalRequiredSpec, dN as ManifestContent, dE as ManifestCreatesSpec, dB as ManifestDryRunSpec, dH as ManifestEffectDeclaration, dG as ManifestEffectSchema, dm as ManifestEnumRuleSpec, dJ as ManifestEventStreamDef, dI as ManifestEventTypeDef, dn as ManifestFilterBySpec, dL as ManifestImport, bg as ManifestListResponse, dK as ManifestOperation, dA as ManifestPostConditionSpec, dk as ManifestPropertySpec, dF as ManifestRelationshipDef, dC as ManifestReverseSpec, dz as ManifestStateMachineSpec, dq as ManifestStateMachineStateSpec, dy as ManifestStateMachineTransitionSpec, ds as ManifestStateTransitionActionSpec, dt as ManifestStateTransitionAssigneeSpec, dx as ManifestStateTransitionExpectedOutcomeSpec, dr as ManifestStateTransitionInputBinding, dw as ManifestStateTransitionPermissionSpec, du as ManifestStateTransitionRelatedStateRequirementSpec, dv as ManifestStateTransitionRequirementsSpec, dl as ManifestValidationOperator, dp as ManifestValidationRuleSpec, dM as ManifestVolume, cq as ManualActionListOptions, co as ManualActionOccurrence, cp as ManualActionRecordResult, cm as ManualActionRelatedRecord, ck as ManualActionSource, cj as ManualActionStatus, cr as ManualActionSuggestion, cs as ManualActionSuggestionOptions, cl as ManualActionTarget, cK as MarkUserEnvironmentReadOptions, aG as MatchedPolicy, q as MessageFeedItem, cU as ModelRef, an as NormalizedOpenAIUsage, N as NormalizedSuggestedArtifact, ap as OPENAI_MODEL_PRICING_USD_PER_MILLION, O as ObjectsFeedItem, am as OpenAIModelPricing, ao as OpenAITokenSpend, au as OpenAIUsageSpendEvent, aN as OpenEnvironmentOptions, b4 as PermissionProfile, b6 as PermissionProfileListResponse, b3 as PermissionRules, aC as PolicyOperator, aE as PolicyOrigin, aB as PolicyPredicateSource, aF as PolicyRuleIR, aA as PolicySource, G as PromptFeedItem, bz as PublishEffectsResult, ag as PublishFeedbackOptions, g as PublishToolsResult, ah as PublishTransientFeedbackOptions, aZ as QuotaLineItemFilter, aW as QuotaPeriod, aV as QuotaScopeType, aX as QuotaStatus, cO as RPCRequest, cR as RPCRequestFromServer, cP as RPCResponse, db as RecordImport, da as RecordImportItem, d8 as RecordImportItemStatus, d6 as RecordImportOptions, d9 as RecordImportStats, d7 as RecordImportStatus, d5 as RecordImportWriteMode, cn as RecordManualActionInput, cA as RecordMentionInput, cX as RecordObjectOptions, d2 as RecordObjectResult, cY as RecordObjectStateValue, d3 as RecordObjectsChunkInfo, d4 as RecordObjectsOptions, av as RecordOpenAIUsageSpendOptions, aw as RecordOpenAIUsageSpendResult, cz as RecordSearchOptions, cy as RecordSearchResult, aL as RecordUserOptions, cV as RelationshipInfo, bq as ResolvedEffectApprovalRequired, bo as ResolvedEffectDryRun, bn as ResolvedEffectPostCondition, bp as ResolvedEffectReverse, de as RunEnvironmentImporterOptions, b0 as Sandbox, b2 as SandboxListResponse, bm as SemanticVersionDiff, bl as SemanticVersionDiffEntry, cd as SessionArtifactApprovalOptions, c3 as SessionArtifactAutonomyPolicy, cc as SessionArtifactExecutionOptions, cb as SessionArtifactExecutionResult, c2 as SessionArtifactKind, c5 as SessionArtifactListOptions, c4 as SessionArtifactRecord, ca as SessionArtifactRelationshipCreateInput, c8 as SessionArtifactRelationshipOption, c7 as SessionArtifactRelationshipOptionsInput, c9 as SessionArtifactRelationshipOptionsResult, c1 as SessionArtifactStatus, c6 as SessionArtifactValidationResult, cC as SessionCollectionListOptions, cE as SessionCollectionListResult, cB as SessionDocumentResult, Y as SessionFeedApi, af as SessionFeedController, a8 as SessionFeedControllerOptions, b_ as SessionFileKind, c0 as SessionFileRecord, bZ as SessionFileSource, b$ as SessionFileStatus, ct as SessionFileUploadOptions, cv as SessionHeapFieldType, cw as SessionHeapFieldValue, cx as SessionHeapVariable, cD as SessionJobListOptions, cu as SessionJobRecord, bY as SessionTimelineEvent, bW as SessionTranscriptActionSuggestion, bX as SessionTranscriptShowRefs, ai as SettleTransientFeedbackOptions, cQ as SnapshotResetMessage, aU as SpendLineItemType, aY as SpendSummary, dR as StreamEvent, dT as StreamStats, dS as StreamSubscription, aM as Subject, y as TableFeedItem, h as ToolHandler, bB as ToolInfo, cS as ToolInvokeParams, cT as ToolResultParams, f as ToolSchema, bD as ToolsChangedEvent, L as TransientFeedItem, H as TransientFeedItemBase, K as TransientFeedbackFeedItem, aj as TransientFeedbackHandle, J as TransientMessageFeedItem, aK as User, cG as UserEnvironmentMessagePreview, cF as UserEnvironmentPrompt, cH as UserEnvironmentSessionState, cI as UserEnvironmentState, cJ as UserEnvironmentStateOptions, bT as UserMessageAppendResult, bS as UserMessageInput, bQ as UserMessageShowRefs, bR as UserMessageTarget, bj as Version, bb as VersionTag, ba as VersionTracking, cN as WSClientOptions, cL as WSDisconnectInfo, cM as WSReconnectErrorInfo, ay as buildOpenAISpendEventId, as as calculateOpenAITokenSpend, al as createFeedPublisher, a7 as emitFeedDiagnostic, a6 as emitFeedDiagnosticToDefaultSink, aa as emptyFeedSnapshot, aq as getOpenAIModelPricing, ab as hasCanonicalSessionFeedActivation, ac as isCanonicalSessionFeedDocument, Z as mergeFeedItemsBySequence, a5 as normalizeFeedDiagnostic, a4 as normalizeFeedDiagnosticKind, ae as normalizeFeedPage, ar as normalizeOpenAIUsage, _ as orderTransientFeedItems, ad as readSessionFeedSnapshot, az as recordOpenAIUsageSpend, ax as toGranularHttpBase } from './spend-CNe-Ff6U.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';
@@ -26,8 +26,16 @@ type EffectRuntimeRequest = {
     input: unknown;
     context?: EffectHandlerContext;
 };
+interface EffectRuntimeFeedbackBridge {
+    /** Ephemeral registry capability for this one active invocation. */
+    invocationId: string;
+    publish: FeedPublishTransport;
+}
+interface InvokeRegisteredEffectOptions {
+    feedback?: EffectRuntimeFeedbackBridge;
+}
 declare function normalizeEffectBehaviors(value?: ManifestEffectMetamodelSpec | ResolvedEffectBehaviors | null): ResolvedEffectBehaviors;
-declare function invokeRegisteredEffect(effectMap: Map<string, ToolWithHandler>, request: EffectRuntimeRequest): Promise<unknown>;
+declare function invokeRegisteredEffect(effectMap: Map<string, ToolWithHandler>, request: EffectRuntimeRequest, options?: InvokeRegisteredEffectOptions): Promise<unknown>;
 
 interface ValidationRuleEvaluationInput {
     operator?: string | null;
@@ -129,6 +137,7 @@ interface LimitPolicySpec {
 }
 
 interface JobPresentation {
+    /** Latest canonical assistant message for this job by server sequence. */
     responseText: string | null;
     entries: SessionHeapEntry[];
     lists: SessionHeapList[];
@@ -136,11 +145,10 @@ interface JobPresentation {
     changedLists: SessionHeapList[];
     hasExplicitArtifacts: boolean;
 }
-declare function resolveJobPresentation({ jobId, result, stdout, agentMessages, sessionHeap, allowExplicitArtifacts, }: {
+declare function resolveJobPresentation({ jobId, result, feedItems, sessionHeap, allowExplicitArtifacts, }: {
     jobId: string;
     result: unknown;
-    stdout?: string[];
-    agentMessages?: unknown[];
+    feedItems?: readonly FeedItem[];
     sessionHeap: SessionHeapSnapshot;
     allowExplicitArtifacts?: boolean;
 }): JobPresentation;
@@ -165,13 +173,27 @@ declare function scorePromptChoiceMatch(answer: string, answerTokens: string[],
     score: number;
     resolvedValue: string | null;
 };
-declare function normalizePromptType(raw: Record<string, unknown> | null | undefined): Prompt["type"];
+declare function normalizePromptType(raw: Record<string, unknown> | null | undefined): Prompt["type"] | null;
 declare function normalizePrompt(rawValue: unknown): Prompt | null;
 declare function resolvePromptAnswer(prompt: Prompt | undefined, answer: unknown): unknown;
 
+type UnknownRecord = Record<string, unknown>;
+/**
+ * Deliberate model/history projection from canonical durable occurrences.
+ * Sequence is the only ordering key; routine and transient feedback are not
+ * included in the next-turn transcript.
+ */
+declare function buildSessionTranscriptFromFeedItems(input: {
+    items: FeedItem[];
+    liveDoc?: UnknownRecord | null;
+}): SessionTranscriptEntry[];
+/**
+ * Build a transcript only from feed-v1. A missing activation marker fails
+ * closed instead of falling back to independently ordered message or job data.
+ */
 declare function buildSessionTranscript(input: {
-    liveDoc?: Record<string, unknown> | null;
-    sessionHeap?: SessionHeapSnapshot;
+    liveDoc?: UnknownRecord | null;
+    canonicalFeedItems?: FeedItem[];
 }): SessionTranscriptEntry[];
 
-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 };
+export { type ConditionalPolicySpec, EffectHandlerContext, EndpointMode, FeedItem, FeedPublishTransport, 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, buildSessionTranscriptFromFeedItems, evaluateValidationRule, extractPromptTokens, invokeRegisteredEffect, isLocalApiUrl, normalizeEffectBehaviors, normalizePrompt, normalizePromptChoiceOption, normalizePromptText, normalizePromptType, resolveApiUrl, resolveAuthTokenForApiUrl, resolveJobPresentation, resolvePromptAnswer, scorePromptChoiceMatch, validationRuleFailureMessage };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { E as Environment, a as EnvironmentSession, G as Granular, O as OntologyHandle, S as Session, W as WSClient } from './client-UdGt44dF.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 './spend-czRX7l0X.js';
-export { cN as APIError, A as AccessTokenProvider, J as AdoptEnvironmentOptions, bg as ArtifactApprovalDecisionInput, bh as ArtifactApprovalDecisionResult, be as ArtifactApprovalTask, bf as ArtifactApprovalTaskListOptions, bd as ArtifactApprovalTaskStatus, aa as Assignment, ab as AssignmentListResponse, al as Build, an as BuildListResponse, ac as BuildPolicy, ak as BuildStatus, C as ConditionIR, K as ConnectOptions, aV as ConversationActionSuggestion, aZ as ConversationAppendResult, aW as ConversationMessageAction, aY as ConversationMessageInput, aX as ConversationMessagePart, aP as ConversationMessageShowRefs, Q as ConversationSessionInfo, W as ConversationSessionListOptions, V as ConversationSessionListStatus, aQ as ConversationTableCell, aR as ConversationTableColumn, aU as ConversationTableProjection, aT as ConversationTableRow, aS as ConversationTableRowReference, ag as CreateEnvironmentData, a8 as CreatePermissionProfileData, a4 as CreateSandboxData, L as CreateSessionOptions, bV as DefineRelationshipOptions, cO as DeleteResponse, D as DomainState, aE as EffectHandler, aB as EffectInfo, av as EffectInvocationMetadata, au as EffectInvocationMode, aw as EffectSchema, az as EffectVersionSelector, ax as EffectWithHandler, aD as EffectsChangedEvent, af as EnvironmentData, aM as EnvironmentFeedbackRecord, ci as EnvironmentImporter, ch as EnvironmentImporterImportOptions, ah as EnvironmentListResponse, cb as EnvironmentRecordImportSummary, cg as EnvironmentSetupImporterClaim, ce as EnvironmentSetupLifecycleStatus, cf as EnvironmentSetupSummary, cc as EnvironmentSetupTriggerReason, b$ as EnvironmentStateMachineProxy, bZ as EnvironmentStateObservationInput, c0 as EnvironmentStateProxy, bY as EnvironmentStateTarget, b_ as EnvironmentStateUpdateInput, z as GranularAuth, y as GranularOptions, a1 as GranularQuotaPolicy, a2 as GranularQuotaProgress, G as GranularSpendContext, cM 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, ai as Manifest, cB as ManifestApprovalRequiredSpec, cL as ManifestContent, cC as ManifestCreatesSpec, cz as ManifestDryRunSpec, cF as ManifestEffectDeclaration, cE as ManifestEffectSchema, cl as ManifestEnumRuleSpec, cH as ManifestEventStreamDef, cG as ManifestEventTypeDef, cm as ManifestFilterBySpec, cJ as ManifestImport, aj as ManifestListResponse, cI as ManifestOperation, cy as ManifestPostConditionSpec, cj as ManifestPropertySpec, cD as ManifestRelationshipDef, cA as ManifestReverseSpec, cx as ManifestStateMachineSpec, co as ManifestStateMachineStateSpec, cw as ManifestStateMachineTransitionSpec, cq as ManifestStateTransitionActionSpec, cr as ManifestStateTransitionAssigneeSpec, cv as ManifestStateTransitionExpectedOutcomeSpec, cp as ManifestStateTransitionInputBinding, cu as ManifestStateTransitionPermissionSpec, cs as ManifestStateTransitionRelatedStateRequirementSpec, ct as ManifestStateTransitionRequirementsSpec, ck as ManifestValidationOperator, cn as ManifestValidationRuleSpec, cK as ManifestVolume, bp as ManualActionListOptions, bn as ManualActionOccurrence, bo as ManualActionRecordResult, bl as ManualActionRelatedRecord, bj as ManualActionSource, bi as ManualActionStatus, bq as ManualActionSuggestion, br as ManualActionSuggestionOptions, bk as ManualActionTarget, bJ as MarkUserEnvironmentReadOptions, x as MatchedPolicy, bT 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, a7 as PermissionProfile, a9 as PermissionProfileListResponse, a6 as PermissionRules, u as PolicyOperator, v as PolicyOrigin, s as PolicyPredicateSource, w as PolicyRuleIR, q as PolicySource, ay as PublishEffectsResult, f as PublishToolsResult, a0 as QuotaLineItemFilter, Z as QuotaPeriod, Y as QuotaScopeType, _ as QuotaStatus, bN as RPCRequest, bQ as RPCRequestFromServer, bO as RPCResponse, ca as RecordImport, c9 as RecordImportItem, c7 as RecordImportItemStatus, c5 as RecordImportOptions, c8 as RecordImportStats, c6 as RecordImportStatus, c4 as RecordImportWriteMode, bm as RecordManualActionInput, bz as RecordMentionInput, bW as RecordObjectOptions, c1 as RecordObjectResult, bX as RecordObjectStateValue, c2 as RecordObjectsChunkInfo, c3 as RecordObjectsOptions, m as RecordOpenAIUsageSpendOptions, o as RecordOpenAIUsageSpendResult, by as RecordSearchOptions, bx as RecordSearchResult, B as RecordUserOptions, bU as RelationshipInfo, at as ResolvedEffectApprovalRequired, ar as ResolvedEffectDryRun, aq as ResolvedEffectPostCondition, as as ResolvedEffectReverse, cd as RunEnvironmentImporterOptions, a3 as Sandbox, a5 as SandboxListResponse, ap as SemanticVersionDiff, ao as SemanticVersionDiffEntry, bc as SessionArtifactApprovalOptions, b6 as SessionArtifactAutonomyPolicy, bb as SessionArtifactExecutionOptions, ba as SessionArtifactExecutionResult, b5 as SessionArtifactKind, b8 as SessionArtifactListOptions, b7 as SessionArtifactRecord, b4 as SessionArtifactStatus, b9 as SessionArtifactValidationResult, bB as SessionCollectionListOptions, bD as SessionCollectionListResult, a_ as SessionConversationMessage, bA as SessionDocumentResult, b1 as SessionFileKind, b3 as SessionFileRecord, b0 as SessionFileSource, b2 as SessionFileStatus, bs as SessionFileUploadOptions, bu as SessionHeapFieldType, bv as SessionHeapFieldValue, bw as SessionHeapVariable, bC as SessionJobListOptions, bt as SessionJobRecord, a$ as SessionTimelineEvent, X as SpendLineItemType, $ as SpendSummary, cP as StreamEvent, cR as StreamStats, cQ as StreamSubscription, F as Subject, bP as SyncMessage, g as ToolHandler, aA as ToolInfo, bR as ToolInvokeParams, bS as ToolResultParams, e as ToolSchema, aC as ToolsChangedEvent, U as User, bF as UserEnvironmentMessagePreview, bE as UserEnvironmentPrompt, bG as UserEnvironmentSessionState, bH as UserEnvironmentState, bI as UserEnvironmentStateOptions, am as Version, ae as VersionTag, ad as VersionTracking, bM as WSClientOptions, bK as WSDisconnectInfo, bL as WSReconnectErrorInfo, p as buildOpenAISpendEventId, k as calculateOpenAITokenSpend, j as getOpenAIModelPricing, n as normalizeOpenAIUsage, r as recordOpenAIUsageSpend, t as toGranularHttpBase } from './spend-czRX7l0X.js';
+export { E as Environment, a as EnvironmentSession, G as Granular, O as OntologyHandle, S as Session, W as WSClient } from './client-BzgQvNyG.js';
+import { E as EndpointMode, T as ToolWithHandler, a as EffectHandlerContext, F as FeedPublishTransport, M as ManifestEffectMetamodelSpec, R as ResolvedEffectBehaviors, S as SessionHeapEntry, b as SessionHeapList, c as FeedItem, d as SessionHeapSnapshot, P as Prompt, e as SessionTranscriptEntry } from './spend-CNe-Ff6U.js';
+export { dP as APIError, aH as AccessTokenProvider, C as ActionSuggestionFeedItem, aO as AdoptEnvironmentOptions, ch as ArtifactApprovalDecisionInput, ci as ArtifactApprovalDecisionResult, cf as ArtifactApprovalTask, cg as ArtifactApprovalTaskListOptions, ce as ArtifactApprovalTaskStatus, A as ArtifactFeedItem, bw as ArtifactOptionsHandler, b7 as Assignment, b8 as AssignmentListResponse, bU as AssistantReplyPublicationInput, bV as AssistantReplyPublicationResult, bi as Build, bk as BuildListResponse, b9 as BuildPolicy, bh as BuildStatus, aD as ConditionIR, aP as ConnectOptions, aR as ConversationSessionInfo, aT as ConversationSessionListOptions, aS as ConversationSessionListStatus, bd as CreateEnvironmentData, b5 as CreatePermissionProfileData, b1 as CreateSandboxData, aQ as CreateSessionOptions, cW as DefineRelationshipOptions, dQ as DeleteResponse, D as DomainState, bs as EffectArtifactOptionsInvocation, bu as EffectArtifactRelationshipOption, bv as EffectArtifactRelationshipOptionsResult, bF as EffectHandler, bC as EffectInfo, bt as EffectInvocationMetadata, br as EffectInvocationMode, bx as EffectSchema, bA as EffectVersionSelector, by as EffectWithHandler, bE as EffectsChangedEvent, bc as EnvironmentData, bN as EnvironmentFeedbackRecord, dj as EnvironmentImporter, di as EnvironmentImporterImportOptions, be as EnvironmentListResponse, dc as EnvironmentRecordImportSummary, dh as EnvironmentSetupImporterClaim, df as EnvironmentSetupLifecycleStatus, dg as EnvironmentSetupSummary, dd as EnvironmentSetupTriggerReason, d0 as EnvironmentStateMachineProxy, c_ as EnvironmentStateObservationInput, d1 as EnvironmentStateProxy, cZ as EnvironmentStateTarget, c$ as EnvironmentStateUpdateInput, a1 as FeedDiagnostic, a2 as FeedDiagnosticListener, a9 as FeedDocumentState, l as FeedFeedbackTone, z as FeedFileSource, k as FeedIconToken, p as FeedItemBase, n as FeedItemKind, U as FeedListOptions, $ as FeedListTransport, s as FeedObjectReference, V as FeedPage, ak as FeedPublisher, Q as FeedSnapshot, a0 as FeedSnapshotRegressionReason, j as FeedSource, i as FeedSourceActor, W as FeedSubscribeOptions, X as FeedSubscriptionChange, t as FeedTableCell, u as FeedTableColumn, x as FeedTableProjection, w as FeedTableRow, v as FeedTableRowReference, o as FeedTarget, m as FeedTransientFeedbackTone, r as FeedbackFeedItem, B as FileFeedItem, a3 as GRANULAR_FEED_DIAGNOSTIC_EVENT, aJ as GranularAuth, aI as GranularOptions, a_ as GranularQuotaPolicy, a$ as GranularQuotaProgress, at as GranularSpendContext, dO as GraphQLResult, bG as InstanceEffectHandler, I as InstanceToolHandler, bP as Job, bL as JobFeedbackInput, bK as JobFeedbackMetadata, bM as JobFeedbackRecord, bI as JobFeedbackSentiment, bJ as JobFeedbackToolCall, bH as JobStatus, bO as JobSubmitResult, bf as Manifest, dD as ManifestApprovalRequiredSpec, dN as ManifestContent, dE as ManifestCreatesSpec, dB as ManifestDryRunSpec, dH as ManifestEffectDeclaration, dG as ManifestEffectSchema, dm as ManifestEnumRuleSpec, dJ as ManifestEventStreamDef, dI as ManifestEventTypeDef, dn as ManifestFilterBySpec, dL as ManifestImport, bg as ManifestListResponse, dK as ManifestOperation, dA as ManifestPostConditionSpec, dk as ManifestPropertySpec, dF as ManifestRelationshipDef, dC as ManifestReverseSpec, dz as ManifestStateMachineSpec, dq as ManifestStateMachineStateSpec, dy as ManifestStateMachineTransitionSpec, ds as ManifestStateTransitionActionSpec, dt as ManifestStateTransitionAssigneeSpec, dx as ManifestStateTransitionExpectedOutcomeSpec, dr as ManifestStateTransitionInputBinding, dw as ManifestStateTransitionPermissionSpec, du as ManifestStateTransitionRelatedStateRequirementSpec, dv as ManifestStateTransitionRequirementsSpec, dl as ManifestValidationOperator, dp as ManifestValidationRuleSpec, dM as ManifestVolume, cq as ManualActionListOptions, co as ManualActionOccurrence, cp as ManualActionRecordResult, cm as ManualActionRelatedRecord, ck as ManualActionSource, cj as ManualActionStatus, cr as ManualActionSuggestion, cs as ManualActionSuggestionOptions, cl as ManualActionTarget, cK as MarkUserEnvironmentReadOptions, aG as MatchedPolicy, q as MessageFeedItem, cU as ModelRef, an as NormalizedOpenAIUsage, N as NormalizedSuggestedArtifact, ap as OPENAI_MODEL_PRICING_USD_PER_MILLION, O as ObjectsFeedItem, am as OpenAIModelPricing, ao as OpenAITokenSpend, au as OpenAIUsageSpendEvent, aN as OpenEnvironmentOptions, b4 as PermissionProfile, b6 as PermissionProfileListResponse, b3 as PermissionRules, aC as PolicyOperator, aE as PolicyOrigin, aB as PolicyPredicateSource, aF as PolicyRuleIR, aA as PolicySource, G as PromptFeedItem, bz as PublishEffectsResult, ag as PublishFeedbackOptions, g as PublishToolsResult, ah as PublishTransientFeedbackOptions, aZ as QuotaLineItemFilter, aW as QuotaPeriod, aV as QuotaScopeType, aX as QuotaStatus, cO as RPCRequest, cR as RPCRequestFromServer, cP as RPCResponse, db as RecordImport, da as RecordImportItem, d8 as RecordImportItemStatus, d6 as RecordImportOptions, d9 as RecordImportStats, d7 as RecordImportStatus, d5 as RecordImportWriteMode, cn as RecordManualActionInput, cA as RecordMentionInput, cX as RecordObjectOptions, d2 as RecordObjectResult, cY as RecordObjectStateValue, d3 as RecordObjectsChunkInfo, d4 as RecordObjectsOptions, av as RecordOpenAIUsageSpendOptions, aw as RecordOpenAIUsageSpendResult, cz as RecordSearchOptions, cy as RecordSearchResult, aL as RecordUserOptions, cV as RelationshipInfo, bq as ResolvedEffectApprovalRequired, bo as ResolvedEffectDryRun, bn as ResolvedEffectPostCondition, bp as ResolvedEffectReverse, de as RunEnvironmentImporterOptions, b0 as Sandbox, b2 as SandboxListResponse, bm as SemanticVersionDiff, bl as SemanticVersionDiffEntry, cd as SessionArtifactApprovalOptions, c3 as SessionArtifactAutonomyPolicy, cc as SessionArtifactExecutionOptions, cb as SessionArtifactExecutionResult, c2 as SessionArtifactKind, c5 as SessionArtifactListOptions, c4 as SessionArtifactRecord, ca as SessionArtifactRelationshipCreateInput, c8 as SessionArtifactRelationshipOption, c7 as SessionArtifactRelationshipOptionsInput, c9 as SessionArtifactRelationshipOptionsResult, c1 as SessionArtifactStatus, c6 as SessionArtifactValidationResult, cC as SessionCollectionListOptions, cE as SessionCollectionListResult, cB as SessionDocumentResult, Y as SessionFeedApi, af as SessionFeedController, a8 as SessionFeedControllerOptions, b_ as SessionFileKind, c0 as SessionFileRecord, bZ as SessionFileSource, b$ as SessionFileStatus, ct as SessionFileUploadOptions, cv as SessionHeapFieldType, cw as SessionHeapFieldValue, cx as SessionHeapVariable, cD as SessionJobListOptions, cu as SessionJobRecord, bY as SessionTimelineEvent, bW as SessionTranscriptActionSuggestion, bX as SessionTranscriptShowRefs, ai as SettleTransientFeedbackOptions, cQ as SnapshotResetMessage, aU as SpendLineItemType, aY as SpendSummary, dR as StreamEvent, dT as StreamStats, dS as StreamSubscription, aM as Subject, y as TableFeedItem, h as ToolHandler, bB as ToolInfo, cS as ToolInvokeParams, cT as ToolResultParams, f as ToolSchema, bD as ToolsChangedEvent, L as TransientFeedItem, H as TransientFeedItemBase, K as TransientFeedbackFeedItem, aj as TransientFeedbackHandle, J as TransientMessageFeedItem, aK as User, cG as UserEnvironmentMessagePreview, cF as UserEnvironmentPrompt, cH as UserEnvironmentSessionState, cI as UserEnvironmentState, cJ as UserEnvironmentStateOptions, bT as UserMessageAppendResult, bS as UserMessageInput, bQ as UserMessageShowRefs, bR as UserMessageTarget, bj as Version, bb as VersionTag, ba as VersionTracking, cN as WSClientOptions, cL as WSDisconnectInfo, cM as WSReconnectErrorInfo, ay as buildOpenAISpendEventId, as as calculateOpenAITokenSpend, al as createFeedPublisher, a7 as emitFeedDiagnostic, a6 as emitFeedDiagnosticToDefaultSink, aa as emptyFeedSnapshot, aq as getOpenAIModelPricing, ab as hasCanonicalSessionFeedActivation, ac as isCanonicalSessionFeedDocument, Z as mergeFeedItemsBySequence, a5 as normalizeFeedDiagnostic, a4 as normalizeFeedDiagnosticKind, ae as normalizeFeedPage, ar as normalizeOpenAIUsage, _ as orderTransientFeedItems, ad as readSessionFeedSnapshot, az as recordOpenAIUsageSpend, ax as toGranularHttpBase } from './spend-CNe-Ff6U.js';
 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.js';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';
@@ -26,8 +26,16 @@ type EffectRuntimeRequest = {
     input: unknown;
     context?: EffectHandlerContext;
 };
+interface EffectRuntimeFeedbackBridge {
+    /** Ephemeral registry capability for this one active invocation. */
+    invocationId: string;
+    publish: FeedPublishTransport;
+}
+interface InvokeRegisteredEffectOptions {
+    feedback?: EffectRuntimeFeedbackBridge;
+}
 declare function normalizeEffectBehaviors(value?: ManifestEffectMetamodelSpec | ResolvedEffectBehaviors | null): ResolvedEffectBehaviors;
-declare function invokeRegisteredEffect(effectMap: Map<string, ToolWithHandler>, request: EffectRuntimeRequest): Promise<unknown>;
+declare function invokeRegisteredEffect(effectMap: Map<string, ToolWithHandler>, request: EffectRuntimeRequest, options?: InvokeRegisteredEffectOptions): Promise<unknown>;
 
 interface ValidationRuleEvaluationInput {
     operator?: string | null;
@@ -129,6 +137,7 @@ interface LimitPolicySpec {
 }
 
 interface JobPresentation {
+    /** Latest canonical assistant message for this job by server sequence. */
     responseText: string | null;
     entries: SessionHeapEntry[];
     lists: SessionHeapList[];
@@ -136,11 +145,10 @@ interface JobPresentation {
     changedLists: SessionHeapList[];
     hasExplicitArtifacts: boolean;
 }
-declare function resolveJobPresentation({ jobId, result, stdout, agentMessages, sessionHeap, allowExplicitArtifacts, }: {
+declare function resolveJobPresentation({ jobId, result, feedItems, sessionHeap, allowExplicitArtifacts, }: {
     jobId: string;
     result: unknown;
-    stdout?: string[];
-    agentMessages?: unknown[];
+    feedItems?: readonly FeedItem[];
     sessionHeap: SessionHeapSnapshot;
     allowExplicitArtifacts?: boolean;
 }): JobPresentation;
@@ -165,13 +173,27 @@ declare function scorePromptChoiceMatch(answer: string, answerTokens: string[],
     score: number;
     resolvedValue: string | null;
 };
-declare function normalizePromptType(raw: Record<string, unknown> | null | undefined): Prompt["type"];
+declare function normalizePromptType(raw: Record<string, unknown> | null | undefined): Prompt["type"] | null;
 declare function normalizePrompt(rawValue: unknown): Prompt | null;
 declare function resolvePromptAnswer(prompt: Prompt | undefined, answer: unknown): unknown;
 
+type UnknownRecord = Record<string, unknown>;
+/**
+ * Deliberate model/history projection from canonical durable occurrences.
+ * Sequence is the only ordering key; routine and transient feedback are not
+ * included in the next-turn transcript.
+ */
+declare function buildSessionTranscriptFromFeedItems(input: {
+    items: FeedItem[];
+    liveDoc?: UnknownRecord | null;
+}): SessionTranscriptEntry[];
+/**
+ * Build a transcript only from feed-v1. A missing activation marker fails
+ * closed instead of falling back to independently ordered message or job data.
+ */
 declare function buildSessionTranscript(input: {
-    liveDoc?: Record<string, unknown> | null;
-    sessionHeap?: SessionHeapSnapshot;
+    liveDoc?: UnknownRecord | null;
+    canonicalFeedItems?: FeedItem[];
 }): SessionTranscriptEntry[];
 
-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 };
+export { type ConditionalPolicySpec, EffectHandlerContext, EndpointMode, FeedItem, FeedPublishTransport, 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, buildSessionTranscriptFromFeedItems, evaluateValidationRule, extractPromptTokens, invokeRegisteredEffect, isLocalApiUrl, normalizeEffectBehaviors, normalizePrompt, normalizePromptChoiceOption, normalizePromptText, normalizePromptType, resolveApiUrl, resolveAuthTokenForApiUrl, resolveJobPresentation, resolvePromptAnswer, scorePromptChoiceMatch, validationRuleFailureMessage };