@sema-agent/core
Version:
Stateless, task-oriented AI agent core
1,866 lines (1,865 loc) • 43.9 kB
JSON
{
"repo": "core",
"version": "7.41.0",
"from": "3ebb5e472b3d7c08c68335719b00d6ecc4b186c6",
"to": "f8fd7c5c5011f7e73fbf0905962efe84dd23715b",
"added": [
{
"name": "AgentApproval",
"kind": "interface",
"tier": "advanced",
"at": [
"src/core/agent-state.ts:36",
"src/index.ts:2931"
],
"criteriaCovered": true,
"breaking": false
},
{
"name": "AgentApprovalState",
"kind": "type",
"tier": "advanced",
"at": [
"src/core/agent-state.ts:33",
"src/index.ts:2932"
],
"criteriaCovered": false,
"breaking": false
},
{
"name": "AgentState",
"kind": "interface",
"tier": "advanced",
"at": [
"src/core/agent-state.ts:50",
"src/index.ts:2930"
],
"criteriaCovered": true,
"breaking": false
},
{
"name": "AgentStateRow",
"kind": "type",
"tier": "advanced",
"at": [
"src/core/agent-state.ts:47",
"src/index.ts:2933"
],
"criteriaCovered": false,
"breaking": false
},
{
"name": "AgentStateSource",
"kind": "interface",
"tier": "advanced",
"at": [
"src/core/agent-state.ts:66",
"src/index.ts:2934"
],
"criteriaCovered": false,
"breaking": false
},
{
"name": "FileUsageWindowStoreOptions",
"kind": "interface",
"tier": "advanced",
"at": [
"src/index.ts:844",
"src/stores/file/index.ts:40",
"src/stores/file/usage-window-store.ts:18"
],
"criteriaCovered": true,
"breaking": false
},
{
"name": "PermissionSeatInputs",
"kind": "interface",
"tier": "advanced",
"at": [
"src/core/mode-policy.ts:135",
"src/index.ts:1468"
],
"criteriaCovered": true,
"breaking": false
},
{
"name": "PermissionSeatReading",
"kind": "interface",
"tier": "advanced",
"at": [
"src/core/mode-policy.ts:130",
"src/index.ts:1468"
],
"criteriaCovered": false,
"breaking": false
},
{
"name": "RULE_TOOL_NAME_VERDICTS",
"kind": "variable",
"tier": "advanced",
"at": [
"src/core/tool-name-aliases.ts:74",
"src/index.ts:973"
],
"criteriaCovered": false,
"breaking": false
},
{
"name": "RuleToolNameVerdict",
"kind": "type",
"tier": "advanced",
"at": [
"src/core/tool-name-aliases.ts:89",
"src/index.ts:973"
],
"criteriaCovered": false,
"breaking": false
},
{
"name": "SessionPolicyStoreOptions",
"kind": "interface",
"tier": "advanced",
"at": [
"src/core/session-policy-store.ts:97",
"src/index.ts:386"
],
"criteriaCovered": true,
"breaking": false
},
{
"name": "SessionRuleNameRefusal",
"kind": "interface",
"tier": "advanced",
"at": [
"src/core/session-policy-store.ts:65",
"src/index.ts:387"
],
"criteriaCovered": true,
"breaking": false
},
{
"name": "SkillGateSeats",
"kind": "interface",
"tier": "advanced",
"at": [
"src/core/skill-grant.ts:386",
"src/index.ts:1469"
],
"criteriaCovered": true,
"breaking": false
},
{
"name": "SkillGrantHit",
"kind": "interface",
"tier": "advanced",
"at": [
"src/core/skill-grant.ts:271",
"src/index.ts:1469"
],
"criteriaCovered": false,
"breaking": false
},
{
"name": "SkillGrantLane",
"kind": "interface",
"tier": "advanced",
"at": [
"src/core/skill-grant.ts:378",
"src/index.ts:1469"
],
"criteriaCovered": false,
"breaking": false
},
{
"name": "SkillGrantRecord",
"kind": "interface",
"tier": "advanced",
"at": [
"src/core/skill-grant.ts:57",
"src/index.ts:1469"
],
"criteriaCovered": false,
"breaking": false
},
{
"name": "TranscriptStep",
"kind": "interface",
"tier": "advanced",
"at": [
"src/agents/subagent-steps.ts:282",
"src/index.ts:2936"
],
"criteriaCovered": true,
"breaking": false
},
{
"name": "agentStateSourceOfRecord",
"kind": "function",
"tier": "advanced",
"at": [
"src/core/agent-state.ts:87",
"src/index.ts:2928"
],
"criteriaCovered": false,
"breaking": false
},
{
"name": "agentStateSummary",
"kind": "function",
"tier": "advanced",
"at": [
"src/core/agent-state.ts:160",
"src/index.ts:2929"
],
"criteriaCovered": false,
"breaking": false
},
{
"name": "assertSessionRuleNamesCurrent",
"kind": "function",
"tier": "advanced",
"at": [
"src/core/session-policy-store.ts:129",
"src/index.ts:385"
],
"criteriaCovered": false,
"breaking": false
},
{
"name": "judgeRuleToolName",
"kind": "function",
"tier": "advanced",
"at": [
"src/core/tool-name-aliases.ts:98",
"src/index.ts:973"
],
"criteriaCovered": false,
"breaking": false
},
{
"name": "readAgentState",
"kind": "function",
"tier": "advanced",
"at": [
"src/core/agent-state.ts:121",
"src/index.ts:2927"
],
"criteriaCovered": false,
"breaking": false
}
],
"removed": [
{
"name": "SkillManifest",
"kind": "interface",
"tier": "advanced",
"at": [
"src/core/agent-definition.ts:121",
"src/core/types.ts:30",
"src/index.ts:3422"
],
"breaking": true
},
{
"name": "skillScopeWriteToolNames",
"kind": "function",
"tier": "advanced",
"at": [
"src/core/tool-registry.ts:54",
"src/index.ts:1061"
],
"breaking": true
}
],
"changed": [],
"narrowed": [],
"closedSetMembers": [
{
"set": "ASK_CLASSES",
"at": [
"src/core/ask-origin.ts:593"
],
"newSet": false,
"added": [
"requires_user_interaction"
],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"set": "AgentApprovalState",
"at": [
"src/core/agent-state.ts:33"
],
"newSet": true,
"added": [
"expired",
"missing",
"pending",
"resolved",
"unreadable"
],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"set": "AgentStateRow",
"at": [
"src/core/agent-state.ts:47"
],
"newSet": true,
"added": [
"durable_row",
"live_row"
],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"set": "CheckpointError.detail.field",
"at": [
"src/core/checkpoint-store.ts:2607"
],
"newSet": false,
"added": [
"boundGrantDigest"
],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"set": "CheckpointErrorReason",
"at": [
"src/core/checkpoint-store.ts:2394"
],
"newSet": false,
"added": [
"skill_grants_damaged"
],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"set": "DecisionReason",
"at": [
"src/core/decision-receipt.ts:27",
"src/core/tool-policy.ts:189",
"src/index.ts:1429"
],
"newSet": false,
"added": [
"skill"
],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"set": "ENGINE_NOTICE_CODES",
"at": [
"src/core/governance-codes.ts:348"
],
"newSet": false,
"added": [
"skills.allowed_tool_not_granted"
],
"removed": [],
"breaking": false,
"criteriaCovered": true
},
{
"set": "HeadlessApproverSeat",
"at": [
"src/core/ask-origin.ts:851"
],
"newSet": true,
"added": [
"absent",
"unavailable"
],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"set": "RULE_TOOL_NAME_VERDICTS",
"at": [
"src/core/tool-name-aliases.ts:74"
],
"newSet": true,
"added": [
"current",
"retired",
"unprefixed_namespace"
],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"set": "SKILL_ENTRY_INERT_REASONS",
"at": [
"src/core/skill-grant.ts:65"
],
"newSet": true,
"added": [
"content_unsupported",
"domain",
"grammar",
"namespace_wildcard",
"path_pattern",
"wildcard_all"
],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"set": "SKILL_GRANT_ORIGINS",
"at": [
"src/core/skill-grant.ts:46"
],
"newSet": true,
"added": [
"inherited",
"model",
"user"
],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"set": "SessionPolicyError.code",
"at": [
"src/core/session-policy-store.ts:79"
],
"newSet": false,
"added": [
"legacy_tool_name"
],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"set": "SkillEntryInertReason",
"at": [
"src/core/skill-grant.ts:66"
],
"newSet": true,
"added": [
"content_unsupported",
"domain",
"grammar",
"namespace_wildcard",
"path_pattern",
"wildcard_all"
],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"set": "SkillGrantOrigin",
"at": [
"src/core/skill-grant.ts:47"
],
"newSet": true,
"added": [
"inherited",
"model",
"user"
],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"set": "SkillsDirectoryWarningCode",
"at": [
"src/core/skills-directory.ts:55"
],
"newSet": false,
"added": [],
"removed": [
"allowed_tool_not_mounted",
"allowed_tool_pattern_unsupported",
"disallowed_tools_unenforced"
],
"breaking": true,
"criteriaCovered": false
},
{
"set": "ToolGateInput.permissionSeat",
"at": [
"src/core/hooks.ts:1804"
],
"newSet": false,
"added": [],
"removed": [
"passthrough"
],
"persistedBy": "none",
"breaking": true,
"criteriaCovered": false
},
{
"set": "TraceEvent.kind",
"at": [
"src/core/trace.ts:62",
"src/core/trace.ts:96",
"src/core/trace.ts:137",
"src/core/trace.ts:167",
"src/core/trace.ts:208",
"src/core/trace.ts:226",
"src/core/trace.ts:241",
"src/core/trace.ts:276",
"src/core/trace.ts:278",
"src/core/trace.ts:321",
"src/core/trace.ts:350",
"src/core/trace.ts:368",
"src/core/trace.ts:382",
"src/core/trace.ts:399",
"src/core/trace.ts:415",
"src/core/trace.ts:430",
"src/core/trace.ts:445",
"src/core/trace.ts:459",
"src/core/trace.ts:477",
"src/core/trace.ts:496",
"src/core/trace.ts:514",
"src/core/trace.ts:539",
"src/core/trace.ts:567",
"src/core/trace.ts:581",
"src/core/trace.ts:595",
"src/core/trace.ts:616",
"src/core/trace.ts:627",
"src/core/trace.ts:642",
"src/core/trace.ts:654",
"src/core/trace.ts:668",
"src/core/trace.ts:687",
"src/core/trace.ts:697",
"src/core/trace.ts:705",
"src/core/trace.ts:715",
"src/core/trace.ts:731",
"src/core/trace.ts:748",
"src/core/trace.ts:760",
"src/core/trace.ts:770",
"src/core/trace.ts:792",
"src/core/trace.ts:814",
"src/core/trace.ts:822",
"src/core/trace.ts:842",
"src/core/trace.ts:858",
"src/core/trace.ts:868",
"src/core/trace.ts:881",
"src/core/trace.ts:895",
"src/core/trace.ts:904",
"src/core/trace.ts:915",
"src/core/trace.ts:925"
],
"newSet": false,
"added": [
"permission.skill_allowed"
],
"removed": [],
"breaking": false,
"criteriaCovered": false
}
],
"closedSetsUnreadable": [],
"typeKeys": [
{
"type": "AgentPollDetailsInput",
"at": [
"src/core/task-registry-agent.ts:2153"
],
"added": [
"agentState"
],
"addedDetail": [
{
"key": "agentState",
"optional": true
}
],
"addedRequired": [],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"type": "AgentTool",
"at": [
"src/engine/loop/types.ts:768"
],
"via": "A2aRefreshResult.tools",
"added": [
"mcpRequiresUserInteraction"
],
"addedDetail": [
{
"key": "mcpRequiresUserInteraction",
"optional": true
}
],
"addedRequired": [],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"type": "AgentTranscriptToolOptions",
"at": [
"src/agents/agent-transcript-tool.ts:23"
],
"added": [
"checkpointSeat"
],
"addedDetail": [
{
"key": "checkpointSeat",
"optional": true
}
],
"addedRequired": [],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"type": "CheckpointState",
"at": [
"src/core/checkpoint-store.ts:1192"
],
"added": [
"skillGrants"
],
"addedDetail": [
{
"key": "skillGrants",
"optional": true
}
],
"addedRequired": [],
"removed": [],
"breaking": false,
"criteriaCovered": true
},
{
"type": "FileSessionPolicyStoreOptions",
"at": [
"src/stores/file/session-policy-store.ts:56"
],
"via": "FileSessionPolicyStore.FileSessionPolicyStoreOptions",
"added": [
"mountedToolNames"
],
"addedDetail": [
{
"key": "mountedToolNames",
"optional": true
}
],
"addedRequired": [],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"type": "FileStorageBackendOptions",
"at": [
"src/stores/file/index.ts:114"
],
"added": [
"sessionPolicy"
],
"addedDetail": [
{
"key": "sessionPolicy",
"optional": true
}
],
"addedRequired": [],
"removed": [],
"breaking": false,
"criteriaCovered": true
},
{
"type": "ListAgentsRow",
"at": [
"src/agents/list-agents-tool.ts:93"
],
"added": [
"agentState"
],
"addedDetail": [
{
"key": "agentState",
"optional": true
}
],
"addedRequired": [],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"type": "ListAgentsToolOptions",
"at": [
"src/agents/list-agents-tool.ts:52"
],
"added": [
"checkpointSeat",
"registry.agentStateSource"
],
"addedDetail": [
{
"key": "checkpointSeat",
"optional": true
},
{
"key": "registry.agentStateSource",
"optional": true
}
],
"addedRequired": [],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"type": "MandateMarks",
"at": [
"src/core/ask-origin.ts:458"
],
"via": "AskClassFacts.AskOriginFacts.mandateMarks",
"added": [
"requiresUserInteraction"
],
"addedDetail": [
{
"key": "requiresUserInteraction",
"optional": true
}
],
"addedRequired": [],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"type": "PendingAction",
"at": [
"src/core/checkpoint-store.ts:958"
],
"added": [
"tool_approval.boundGrantDigest"
],
"addedDetail": [
{
"key": "tool_approval.boundGrantDigest",
"optional": true
}
],
"addedRequired": [],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"type": "Prepared",
"at": [
"src/core/runner/contracts.ts:246"
],
"via": "Runner.SuspendReap.env",
"added": [
"approvedCallScreen",
"skillGrants",
"skillSpecs"
],
"addedDetail": [
{
"key": "approvedCallScreen",
"optional": true
},
{
"key": "skillGrants",
"optional": false
},
{
"key": "skillSpecs",
"optional": false
}
],
"addedRequired": [
"skillGrants",
"skillSpecs"
],
"removed": [],
"breaking": true,
"criteriaCovered": false
},
{
"type": "PromotedRecord",
"at": [
"src/core/auto-promote.ts:48"
],
"added": [],
"addedDetail": [],
"addedRequired": [],
"removed": [
"gate3Scoped",
"lineageId",
"manifest"
],
"breaking": true,
"criteriaCovered": false
},
{
"type": "RunInternals",
"at": [
"src/core/runner/contracts.ts:1415"
],
"added": [
"inheritedSkillGrants"
],
"addedDetail": [
{
"key": "inheritedSkillGrants",
"optional": true
}
],
"addedRequired": [],
"removed": [
"inheritedManifestScope"
],
"breaking": true,
"criteriaCovered": false
},
{
"type": "SkillSpec",
"at": [
"src/core/agent-definition.ts:108"
],
"added": [
"allowedTools",
"disallowedTools"
],
"addedDetail": [
{
"key": "allowedTools",
"optional": true
},
{
"key": "disallowedTools",
"optional": true
}
],
"addedRequired": [],
"removed": [
"manifest"
],
"breaking": true,
"criteriaCovered": true
},
{
"type": "SkillsDirectoryOptions",
"at": [
"src/core/skills-directory.ts:84"
],
"added": [],
"addedDetail": [],
"addedRequired": [],
"removed": [
"deployedTools"
],
"breaking": true,
"criteriaCovered": false
},
{
"type": "TaskPollOptions",
"at": [
"src/core/task-registry.ts:204"
],
"via": "TaskRegistry.TaskPollOptions",
"added": [
"checkpointSeat"
],
"addedDetail": [
{
"key": "checkpointSeat",
"optional": true
}
],
"addedRequired": [],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"type": "TaskSpec",
"at": [
"src/core/task-spec.ts:52"
],
"added": [
"userInvokedSkills"
],
"addedDetail": [
{
"key": "userInvokedSkills",
"optional": true
}
],
"addedRequired": [],
"removed": [],
"breaking": false,
"criteriaCovered": true
},
{
"type": "TaskToolOptions",
"at": [
"src/core/task-registry.ts:248"
],
"via": "createTaskOutputTool.TaskToolOptions",
"added": [
"checkpointSeat"
],
"addedDetail": [
{
"key": "checkpointSeat",
"optional": true
}
],
"addedRequired": [],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"type": "ToolExecuteContext",
"at": [
"src/core/tool-spec.ts:613"
],
"added": [
"activeSkillGrants"
],
"addedDetail": [
{
"key": "activeSkillGrants",
"optional": true
}
],
"addedRequired": [],
"removed": [
"activeSkillScope"
],
"breaking": true,
"criteriaCovered": true
},
{
"type": "ToolGateInput",
"at": [
"src/core/hooks.ts:1469"
],
"via": "runToolGate.ToolGateInput",
"added": [
"permissionSeatOf",
"requiresUserInteraction",
"skillGrants",
"skillGrants.onAllowed"
],
"addedDetail": [
{
"key": "permissionSeatOf",
"optional": true
},
{
"key": "requiresUserInteraction",
"optional": true
},
{
"key": "skillGrants",
"optional": true
},
{
"key": "skillGrants.onAllowed",
"optional": true
}
],
"addedRequired": [],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"type": "TraceEvent",
"at": [
"src/core/trace.ts:60"
],
"added": [
"permission.skill_allowed.entries",
"permission.skill_allowed.kind",
"permission.skill_allowed.skill",
"permission.skill_allowed.taskId",
"permission.skill_allowed.toolCallId",
"permission.skill_allowed.toolName",
"permission.skill_allowed.ts",
"permission.skill_allowed.version"
],
"addedDetail": [
{
"key": "permission.skill_allowed.entries",
"optional": false
},
{
"key": "permission.skill_allowed.kind",
"optional": false
},
{
"key": "permission.skill_allowed.skill",
"optional": false
},
{
"key": "permission.skill_allowed.taskId",
"optional": false
},
{
"key": "permission.skill_allowed.toolCallId",
"optional": false
},
{
"key": "permission.skill_allowed.toolName",
"optional": false
},
{
"key": "permission.skill_allowed.ts",
"optional": false
},
{
"key": "permission.skill_allowed.version",
"optional": false
}
],
"addedRequired": [],
"removed": [],
"breaking": false,
"criteriaCovered": false
},
{
"type": "UnifiedTaskOutput",
"at": [
"src/core/task-registry-shared.ts:41"
],
"added": [
"agentState"
],
"addedDetail": [
{
"key": "agentState",
"optional": true
}
],
"addedRequired": [],
"removed": [],
"breaking": false,
"criteriaCovered": false
}
],
"typeKeysUnreadableArms": [],
"typeKeysFlattenedCount": 220,
"signatures": [
{
"name": "CheckpointError.constructor",
"at": [
"src/core/checkpoint-store.ts:2426"
],
"from": [
"(code: \"checkpoint.already_exists\" | \"checkpoint.already_resolved\" | \"checkpoint.config_refused\" | \"checkpoint.cwd_conflicts_restore\" | \"checkpoint.execution_outcome_conflict\" | \"checkpoint.gate_mismatch\" | \"checkpoint.invalid_outcome\" | \"checkpoint.not_found\" | \"checkpoint.reopen_failed\" | \"checkpoint.reopen_revote\" | \"checkpoint.reopened_concurrently\" | \"checkpoint.resume_aborted\" | \"checkpoint.unsupported_version\" | \"checkpoint.walltime_axis_retired\" | \"resume.constraint_rejected\" | \"resume.constraint_unprojectable\" | \"resume.parent_constraint_mismatch\" | \"resume.parent_constraint_missing\" | \"resume.placement_mismatch\" | \"resume.preflight_rejected\" | \"resume.principal_mismatch\" | \"resume.usage_window_exhausted\" | \"steering.blocked_by_hook\" | \"steering.duplicate_input_id\" | \"steering.invalid_content\" | \"steering.queue_full\" | \"wake.gate_pending\" | \"wake.nothing_to_deliver\", message: string, detail?: { field?: \"boundCallId\" | \"boundInputHash\" | \"answer\" | \"hostDecision\" | \"approver\" | \"taskConfig\" | \"inheritedGate\"; code?: CheckpointConfigRefusalCode; retryAfterMs?: number; reason?: CheckpointErrorReason; })"
],
"to": [
"(code: \"checkpoint.already_exists\" | \"checkpoint.already_resolved\" | \"checkpoint.config_refused\" | \"checkpoint.cwd_conflicts_restore\" | \"checkpoint.execution_outcome_conflict\" | \"checkpoint.gate_mismatch\" | \"checkpoint.invalid_outcome\" | \"checkpoint.not_found\" | \"checkpoint.reopen_failed\" | \"checkpoint.reopen_revote\" | \"checkpoint.reopened_concurrently\" | \"checkpoint.resume_aborted\" | \"checkpoint.unsupported_version\" | \"checkpoint.walltime_axis_retired\" | \"resume.constraint_rejected\" | \"resume.constraint_unprojectable\" | \"resume.parent_constraint_mismatch\" | \"resume.parent_constraint_missing\" | \"resume.placement_mismatch\" | \"resume.preflight_rejected\" | \"resume.principal_mismatch\" | \"resume.usage_window_exhausted\" | \"steering.blocked_by_hook\" | \"steering.duplicate_input_id\" | \"steering.invalid_content\" | \"steering.queue_full\" | \"wake.gate_pending\" | \"wake.nothing_to_deliver\", message: string, detail?: { field?: \"boundCallId\" | \"boundInputHash\" | \"boundGrantDigest\" | \"answer\" | \"hostDecision\" | \"approver\" | \"taskConfig\" | \"inheritedGate\"; code?: CheckpointConfigRefusalCode; retryAfterMs?: number; reason?: CheckpointErrorReason; })"
],
"changes": [
{
"aspect": "param",
"detail": "param 3 `detail` type widened: …\" | \"boundInputHash\" | \"[ -> boundGrantDigest\" | \"]answer\" | \"hostDecision\"…",
"breaking": false
}
],
"breaking": false,
"criteriaCovered": false
},
{
"name": "FileUsageWindowStore.constructor",
"at": [
"src/stores/file/usage-window-store.ts:45"
],
"from": [
"(root: string)"
],
"to": [
"(root: string, opts?: FileUsageWindowStoreOptions)"
],
"changes": [
{
"aspect": "param",
"detail": "+optional param `opts?: FileUsageWindowStoreOptions`",
"breaking": false
}
],
"breaking": false,
"criteriaCovered": false
},
{
"name": "SessionPolicyError.constructor",
"at": [
"src/core/session-policy-store.ts:78"
],
"from": [
"(code: \"conflict\" | \"corrupt\" | \"loosen_forbidden\", message: string)"
],
"to": [
"(code: \"conflict\" | \"corrupt\" | \"legacy_tool_name\" | \"loosen_forbidden\", message: string, detail?: SessionRuleNameRefusal)"
],
"changes": [
{
"aspect": "param",
"detail": "+optional param `detail?: SessionRuleNameRefusal`",
"breaking": false
}
],
"breaking": false,
"criteriaCovered": false
},
{
"name": "createFileTaskListStore",
"at": [
"src/stores/file/task-list-store.ts:47"
],
"from": [
"(root: string, opts?: { dataRoot?: string; }): TaskListStore"
],
"to": [
"(root: string, opts?: { dataRoot?: string; onCorruptRead?: (info: CorruptReadInfo) => void; }): TaskListStore"
],
"changes": [
{
"aspect": "param",
"detail": "param 2 `opts` type widened: { dataRoot?: string; [ -> onCorruptRead?: (info: CorruptReadInfo) => void; ]}",
"breaking": false
}
],
"breaking": false,
"criteriaCovered": false
},
{
"name": "deriveTripwire",
"at": [
"src/core/auto-promote.ts:210"
],
"from": [
"(artifactText: string, declared: SkillManifest, profileTokens?: ReadonlySet<string>): TripwireResult"
],
"to": [
"(artifactText: string, declared: Pick<SkillSpec, \"allowedTools\">, profileTokens?: ReadonlySet<string>): TripwireResult"
],
"changes": [
{
"aspect": "param",
"detail": "param 2 `declared` type changed, direction not read: [SkillManifest -> Pick<SkillSpec, \"allowedTools\">]",
"breaking": true,
"uncertain": true
}
],
"uncertain": "param 2 `declared` type changed, direction not read: [SkillManifest -> Pick<SkillSpec, \"allowedTools\">] — the direction of a type change is not read syntactically, so it is reported breaking: check whether existing call sites still type-check before writing the BREAKING line",
"breaking": true,
"criteriaCovered": false
},
{
"name": "loosenReasons",
"at": [
"src/core/session-policy-store.ts:271"
],
"from": [
"(prior: SessionPermissionRules, next: SessionPermissionRules): string[]"
],
"to": [
"(prior: SessionPermissionRules, next: SessionPermissionRules, mountedToolNames?: ReadonlySet<string>): string[]"
],
"changes": [
{
"aspect": "param",
"detail": "+optional param `mountedToolNames?: ReadonlySet<string>`",
"breaking": false
}
],
"breaking": false,
"criteriaCovered": false
},
{
"name": "serveDurableAgentRowLane",
"at": [
"src/core/task-registry-agent.ts:2214"
],
"from": [
"(row: BackgroundAgentRecord): UnifiedTaskResult"
],
"to": [
"(row: BackgroundAgentRecord, agentState?: AgentState): UnifiedTaskResult"
],
"changes": [
{
"aspect": "param",
"detail": "+optional param `agentState?: AgentState`",
"breaking": false
}
],
"breaking": false,
"criteriaCovered": false
}
],
"declarationMoves": [
{
"name": "formatAgo",
"kind": null,
"onSurface": false,
"from": [
"src/agents/list-agents-tool.ts"
],
"to": [
"src/agents/list-agents-tool.ts",
"src/core/agent-state.ts"
]
},
{
"name": "resolveMcpDeclaredResultSize",
"kind": null,
"onSurface": false,
"from": [
"src/core/mcp.ts"
],
"to": [
"src/core/mcp-tool-meta.ts",
"src/core/mcp.ts"
]
}
],
"mintMoves": [],
"criteriaObserves": [
{
"kind": "engineNoticeCode",
"name": "delegation.ask_unresolvable",
"assertions": [
"G19.b",
"G19.c"
]
},
{
"kind": "engineNoticeCode",
"name": "skills.allowed_tool_not_granted",
"assertions": [
"G12.a"
]
},
{
"kind": "taskEventField",
"name": "tool_end.gate",
"assertions": [
"G6.b",
"G6.d",
"G13.b",
"G13.c",
"G13.f",
"G15.a",
"G15.e",
"G15.f",
"G15.g",
"G19.a",
"G19.c"
]
},
{
"kind": "taskEventField",
"name": "tool_end.isError",
"assertions": [
"G5.b",
"G15.g"
]
},
{
"kind": "taskEventField",
"name": "tool_end.output",
"assertions": [
"G6.b",
"G6.c",
"G7.a",
"G19.a"
]
},
{
"kind": "taskEventField",
"name": "tool_start.args",
"assertions": [
"G7.a"
]
},
{
"kind": "typeMember",
"name": "AdoptLocalDataRootOptions.toPrincipal",
"assertions": [
"G18.c"
]
},
{
"kind": "typeMember",
"name": "AgentApproval.checkpointId",
"assertions": [
"G1.b"
]
},
{
"kind": "typeMember",
"name": "AgentApproval.deadline",
"assertions": [
"G1.b"
]
},
{
"kind": "typeMember",
"name": "AgentApproval.state",
"assertions": [
"G1.c"
]
},
{
"kind": "typeMember",
"name": "AgentState.approval",
"assertions": [
"G1.b"
]
},
{
"kind": "typeMember",
"name": "AgentState.lastActivityAt",
"assertions": [
"G1.a",
"G3.a"
]
},
{
"kind": "typeMember",
"name": "AgentState.readAt",
"assertions": [
"G1.a"
]
},
{
"kind": "typeMember",
"name": "AgentState.row",
"assertions": [
"G2.b"
]
},
{
"kind": "typeMember",
"name": "AgentState.status",
"assertions": [
"G1.a"
]
},
{
"kind": "typeMember",
"name": "AskRequest.askClass",
"assertions": [
"G13.a",
"G13.b",
"G13.d",
"G13.e"
]
},
{
"kind": "typeMember",
"name": "AskRequest.classes",
"assertions": [
"G9.c",
"G13.a"
]
},
{
"kind": "typeMember",
"name": "AskRequest.mandated",
"assertions": [
"G13.a"
]
},
{
"kind": "typeMember",
"name": "AskRequest.message",
"assertions": [
"G12.c"
]
},
{
"kind": "typeMember",
"name": "AskRequest.origin",
"assertions": [
"G13.a"
]
},
{
"kind": "typeMember",
"name": "AskRequest.requiresRealApproval",
"assertions": [
"G13.e",
"G13.f"
]
},
{
"kind": "typeMember",
"name": "BackgroundChildEvent.recentSteps",
"assertions": [
"G14.a"
]
},
{
"kind": "typeMember",
"name": "Checkpoint.pendingAction.boundGrantDigest",
"assertions": [
"G15.d"
]
},
{
"kind": "typeMember",
"name": "Checkpoint.status",
"assertions": [
"G15.c"
]
},
{
"kind": "typeMember",
"name": "CheckpointError.code",
"assertions": [
"G15.c"
]
},
{
"kind": "typeMember",
"name": "CheckpointError.detail.field",
"assertions": [
"G15.d",
"G15.e",
"G15.f"
]
},
{
"kind": "typeMember",
"name": "CheckpointError.detail.reason",
"assertions": [
"G15.c"
]
},
{
"kind": "typeMember",
"name": "CheckpointState.skillGrants",
"assertions": [
"G15.a",
"G15.b"
]
},
{
"kind": "typeMember",
"name": "FileDurableRulePartitionProvider.forLocalOwner",
"assertions": [
"G17.f"
]
},
{
"kind": "typeMember",
"name": "FileDurableRulePartitionProvider.forPrincipal",
"assertions": [
"G17.c"
]
},
{
"kind": "typeMember",
"name": "FileDurableRulePartitionProvider.orgStatePersistence",
"assertions": [
"G17.c"
]
},
{
"kind": "typeMember",
"name": "FileMailboxStore.append",
"assertions": [
"G17.d"
]
},
{
"kind": "typeMember",
"name": "FileStorageBackendOptions.onCorruptRead",
"assertions": [
"G17.b"
]
},
{
"kind": "typeMember",
"name": "FileStorageBackendOptions.sessionPolicy",
"assertions": [
"G20.c"
]
},
{
"kind": "typeMember",
"name": "FileStorageCorruptReadInfo.path",
"assertions": [
"G4.b",
"G17.b"
]
},
{
"kind": "typeMember",
"name": "FileStorageCorruptReadInfo.reason",
"assertions": [
"G4.b"
]
},
{
"kind": "typeMember",
"name": "FileStorageCorruptReadInfo.sessionId",
"assertions": [
"G18.a"
]
},
{
"kind": "typeMember",
"name": "FileStoreLockError.code",
"assertions": [
"G17.c",
"G17.e"
]
},
{
"kind": "typeMember",
"name": "FileStoreLockError.lockPath",
"assertions": [
"G17.c"
]
},
{
"kind": "typeMember",
"name": "FileUsageWindowStoreOptions.onCorruptRead",
"assertions": [
"G17.b"
]
},
{
"kind": "typeMember",
"name": "HookToolContext.identity",
"assertions": [
"G6.a"
]
},
{
"kind": "typeMember",
"name": "Hooks.postToolUse",
"assertions": [
"G5.a"
]
},
{
"kind": "typeMember",
"name": "Hooks.postToolUseFailure",
"assertions": [
"G5.a"
]
},
{
"kind": "typeMember",
"name": "Hooks.preToolUse",
"assertions": [
"G6.a"
]
},
{
"kind": "typeMember",
"name": "Hooks.preToolUseObservational",
"assertions": [
"G7.b"
]
},
{
"kind": "typeMember",
"name": "PermissionSeatInputs.permissionSeatOf",
"assertions": [
"G16.c"
]
},
{
"kind": "typeMember",
"name": "PromotedRecord.gate2Verdict",
"assertions": [
"G16.d"
]
},
{
"kind": "typeMember",
"name": "SessionPolicyError.code",
"assertions": [
"G20.a"
]
},
{
"kind": "typeMember",
"name": "SessionPolicyError.detail",
"assertions": [
"G20.a"
]
},
{
"kind": "typeMember",
"name": "SessionPolicyStore.deleteBySession",
"assertions": [
"G18.b",
"G18.d"
]
},
{
"kind": "typeMember",
"name": "SessionPolicyStore.getRules",
"assertions": [
"G4.c",
"G18.b"
]
},
{
"kind": "typeMember",
"name": "SessionPolicyStore.listBySession",
"assertions": [
"G18.a",
"G18.d"
]
},
{
"kind": "typeMember",
"name": "SessionPolicyStore.putRules",
"assertions": [
"G4.a",
"G20.b"
]
},
{
"kind": "typeMember",
"name": "SessionPolicyStoreOptions.mountedToolNames",
"assertions": [
"G20.c"
]
},
{
"kind": "typeMember",
"name": "SessionRuleNameRefusal.currentName",
"assertions": [
"G20.a"
]
},
{
"kind": "typeMember",
"name": "SkillGateSeats.skillGrants",
"assertions": [
"G16.c"
]
},
{
"kind": "typeMember",
"name": "SkillSpec.allowedTools",
"assertions": [
"G8.a",
"G8.b",
"G8.d",
"G9.a",
"G12.d",
"G16.a"
]
},
{
"kind": "typeMember",
"name": "SkillSpec.disallowedTools",
"assertions": [
"G8.c",
"G10.a",
"G10.b",
"G10.d",
"G16.a"
]
},
{
"kind": "typeMember",
"name": "SkillsDirectoryWarning.code",
"assertions": [
"G16.a"
]
},
{
"kind": "typeMember",
"name": "SubagentStep.outcome",
"assertions": [
"G14.a",
"G14.b"
]
},
{
"kind": "typeMember",
"name": "TaskListStore.list",
"assertions": [
"G17.a"
]
},
{
"kind": "typeMember",
"name": "TaskNotificationPayload.recentSteps",
"assertions": [
"G14.a"
]
},
{
"kind": "typeMember",
"name": "TaskResult.terminal",
"assertions": [
"G16.b",
"G20.b"
]
},
{
"kind": "typeMember",
"name": "TaskSpec.permissionMode",
"assertions": [
"G11.c",
"G12.b"
]
},
{
"kind": "typeMember",
"name": "TaskSpec.shellGate",
"assertions": [
"G9.b"
]
},
{
"kind": "typeMember",
"name": "TaskSpec.userInvokedSkills",
"assertions": [
"G10.c",
"G11.a",
"G11.b"
]
},
{
"kind": "typeMember",
"name": "ToolExecuteContext.activeSkillGrants",
"assertions": [
"G11.d"
]
},
{
"kind": "typeMember",
"name": "TranscriptStep.at",
"assertions": [
"G2.a"
]
},
{
"kind": "typeMember",
"name": "TranscriptStep.inFlight",
"assertions": [
"G2.a"
]
},
{
"kind": "typeMember",
"name": "TranscriptStep.outcome",
"assertions": [
"G14.c"
]
}
],
"consumersHint": {
"cli": [
"ASK_CLASSES",
"AgentTool",
"CheckpointError",
"CheckpointErrorReason",
"CheckpointState",
"DecisionReason",
"ENGINE_NOTICE_CODES",
"ListAgentsRow",
"ListAgentsToolOptions",
"PendingAction",
"Prepared",
"RunInternals",
"SessionPolicyError",
"SkillSpec",
"TaskSpec",
"ToolExecuteContext",
"ToolGateInput",
"TraceEvent",
"loosenReasons"
],
"server": [
"ASK_CLASSES",
"AgentTool",
"CheckpointError",
"CheckpointErrorReason",
"CheckpointState",
"DecisionReason",
"ENGINE_NOTICE_CODES",
"FileStorageBackendOptions",
"FileUsageWindowStore",
"ListAgentsRow",
"ListAgentsToolOptions",
"PendingAction",
"Prepared",
"RunInternals",
"SessionPolicyError",
"SkillManifest",
"SkillSpec",
"TaskSpec",
"ToolExecuteContext",
"ToolGateInput",
"TraceEvent",
"UnifiedTaskOutput",
"loosenReasons"
],
"sdk": [
"ASK_CLASSES",
"CheckpointError",
"CheckpointErrorReason",
"DecisionReason",
"ENGINE_NOTICE_CODES",
"PendingAction",
"SessionPolicyError",
"SkillSpec",
"TaskSpec",
"TraceEvent",
"UnifiedTaskOutput"
],
"note": "scanned cli@c4edc6d0 server@e89bb2d4 sdk@ea0c353 — a name listed is MENTIONED there today, which is evidence of consumption, not proof of it. Ledger files (**/docs/core-consumption/**, **/docs/wire-consumption/**, **/*LEDGER*.json) are not evidence of use — server: 9 name(s) matched ONLY in bookkeeping files and were set aside (AgentPollDetailsInput, AgentTranscriptToolOptions, PromotedRecord, SkillsDirectoryOptions, SkillsDirectoryWarningCode, createFileTaskListStore, deriveTripwire, serveDurableAgentRowLane, skillScopeWriteToolNames)"
},
"breakingCount": 11,
"breakingItems": [
"closed set lost members: SkillsDirectoryWarningCode -allowed_tool_not_mounted,allowed_tool_pattern_unsupported,disallowed_tools_unenforced",
"closed set lost members: ToolGateInput.permissionSeat -passthrough",
"export removed: SkillManifest (interface)",
"export removed: skillScopeWriteToolNames (function)",
"signature changed: deriveTripwire — param 2 `declared` type changed, direction not read: [SkillManifest -> Pick<SkillSpec, \"allowedTools\">]",
"type gained required keys: Prepared +skillGrants,skillSpecs",
"type lost keys: PromotedRecord -gate3Scoped,lineageId,manifest",
"type lost keys: RunInternals -inheritedManifestScope",
"type lost keys: SkillSpec -manifest",
"type lost keys: SkillsDirectoryOptions -deployedTools",
"type lost keys: ToolExecuteContext -activeSkillScope"
]
}