@granular-software/sdk 0.4.49 → 0.4.51

package/dist/index.d.ts

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