@kodax-ai/kodax 0.7.83 → 0.7.85

package/dist/types-chunks/{types-Bf3Y3mW-.d.ts → types-PHjfwebT.d.ts}

@@ -1,88 +1,9 @@
-import { k as KodaXMessage } from './types.d-CgrXrFrq.js';
-
 /**
  * @kodax-ai/agent Types
  *
  * 通用 Agent 类型定义
  */
 
-type KodaXJsonPrimitive = string | number | boolean | null;
-type KodaXJsonValue = KodaXJsonPrimitive | KodaXJsonValue[] | {
-    [key: string]: KodaXJsonValue;
-};
-interface KodaXSessionEntryBase {
-    id: string;
-    parentId: string | null;
-    timestamp: string;
-    /**
-     * Stable logical identity for this transcript item. Cloned/forked entries get
-     * a fresh physical `id` but keep their source entry's `logicalId`, allowing
-     * SDK hosts to group or fold cloned history without comparing content.
-     */
-    logicalId?: string;
-    /** Root physical entry id this item was cloned from, when it is a clone. */
-    sourceEntryId?: string;
-}
-interface KodaXSessionMessageEntry extends KodaXSessionEntryBase {
-    type: 'message';
-    message: KodaXMessage;
-}
-interface KodaXSessionCompactionEntry extends KodaXSessionEntryBase {
-    type: 'compaction';
-    summary: string;
-    firstKeptEntryId?: string;
-    tokensBefore?: number;
-    tokensAfter?: number;
-    artifactLedgerId?: string;
-    reason?: string;
-    details?: KodaXJsonValue;
-    memorySeed?: KodaXCompactMemorySeed;
-    /**
-     * FEATURE_072: post-compact ledger summary + file-content messages that
-     * are inlined after the compaction summary at slicer time
-     * (`getSessionMessagesFromLineage`). Stored here so they leave the active
-     * path automatically when a new compaction entry is appended.
-     *
-     * NOTE: attachments are emitted by the slicer, NOT by `getContextMessagesForEntry`
-     * — preserving the latter's 1-to-1 contract that `entryMatchesContextMessage`
-     * and FEATURE_073's future slicing both depend on.
-     */
-    postCompactAttachments?: readonly KodaXMessage[];
-}
-interface KodaXSessionBranchSummaryEntry extends KodaXSessionEntryBase {
-    type: 'branch_summary';
-    summary: string;
-    fromId?: string;
-    details?: KodaXJsonValue;
-}
-interface KodaXSessionLabelEntry extends KodaXSessionEntryBase {
-    type: 'label';
-    targetId: string;
-    label?: string;
-}
-interface KodaXSessionArchiveMarkerEntry extends KodaXSessionEntryBase {
-    type: 'archive_marker';
-    /** Links to the corresponding batch in the .archive.jsonl sidecar file */
-    archiveBatchId: string;
-    /** Number of entries that were archived in this batch */
-    archivedEntryCount: number;
-    /** Brief summary of the archived content */
-    summary: string;
-}
-interface KodaXSessionRewindMarkerEntry extends KodaXSessionEntryBase {
-    type: 'rewind_marker';
-    targetId: string;
-    fromId?: string;
-    truncatedCount: number;
-    summary: string;
-}
-interface KodaXSessionClientNoticeEntry extends KodaXSessionEntryBase {
-    type: 'client_notice';
-    source: string;
-    content: string;
-    turnId?: string;
-    payload?: KodaXJsonValue;
-}
 interface KodaXMemoryOutcomeDigest {
     readonly id: string;
     readonly reviewKey: string;
@@ -110,10 +31,19 @@ interface KodaXMemoryOutcomeDigest {
      * governed reviewer, never proof that Memory was queued or applied.
      */
     readonly memoryIntent?: KodaXMemoryIntent;
+    /** Explicit Memory operations already completed during this episode. */
+    readonly handledMemoryOperations?: readonly KodaXHandledMemoryOperation[];
     readonly memoryInfluence?: readonly KodaXMemoryInfluenceRef[];
     readonly visibility: 'prompt_safe' | 'private' | 'sensitive';
     readonly createdAt: string;
 }
+interface KodaXHandledMemoryOperation {
+    readonly operation: 'remember' | 'correct' | 'forget';
+    readonly disposition?: 'applied' | 'decision' | 'blocked';
+    readonly statement?: string;
+    readonly claimKey?: string;
+    readonly targetRefIds: readonly string[];
+}
 interface KodaXMemoryIntent {
     readonly operation: 'remember' | 'correct';
     readonly evidenceRef: string;
@@ -133,92 +63,6 @@ interface KodaXMemoryInfluenceRef {
     readonly decisionReceiptRef: string;
     readonly grade: 'direct' | 'supporting' | 'exposed' | 'unknown';
 }
-interface KodaXSessionMemoryOutcomeDigestEntry extends KodaXSessionEntryBase {
-    readonly type: 'memory_outcome_digest';
-    readonly digest: KodaXMemoryOutcomeDigest;
-    /** Durable F263 review job identity. Absent on pre-F263 lineage records. */
-    readonly jobId?: string;
-}
-interface KodaXSessionMemoryReviewReceiptEntry extends KodaXSessionEntryBase {
-    readonly type: 'memory_review_receipt';
-    /** Distinguishes repeated review keys across branch epochs. */
-    readonly jobId?: string;
-    readonly reviewKey: string;
-    readonly proposalIds: readonly string[];
-    readonly status: 'completed' | 'no_action';
-    readonly completedAt: string;
-}
-type KodaXGoalStatus = 'active' | 'paused' | 'budget_limited' | 'blocked' | 'complete';
-/**
- * Persistent user-set goal state. v0.7.44 FEATURE_192 — backs the
- * `/goal` slash command and the get_goal / create_goal / update_goal
- * tools.
- *
- * Persistence model: each lifecycle event (create / update / pause /
- * resume / clear / budget_limited / blocked / complete) appends a
- * `KodaXSessionGoalEntry` carrying a frozen `KodaXGoalState` snapshot
- * to the session lineage. `readLatestGoalFromBranch` walks the active
- * branch's message-entry IDs and returns the latest goal entry whose
- * parentId belongs to that branch — so forks and rewinds naturally
- * drop goals attached to abandoned message paths.
- */
-interface KodaXGoalState {
-    readonly version: 1;
-    /** `${createdAt}-${rand}` — stable across updates of the same goal. */
-    readonly id: string;
-    readonly objective: string;
-    readonly status: KodaXGoalStatus;
-    /** Optional explicit token budget; null when the user did not set one. */
-    readonly tokenBudget: number | null;
-    readonly tokensUsed: number;
-    readonly timeUsedSeconds: number;
-    /** Consecutive turns the model has reported the same blocker. */
-    readonly blockerTurnCount: number;
-    /** The blocker_kind string the model last reported, or null. */
-    readonly lastBlockerKind: string | null;
-    readonly createdAt: number;
-    readonly updatedAt: number;
-}
-type KodaXGoalEventType = 'created' | 'updated' | 'paused' | 'resumed' | 'cleared' | 'budget_limited' | 'blocked' | 'complete';
-interface KodaXSessionGoalEntry extends KodaXSessionEntryBase {
-    type: 'goal';
-    /** Snapshot at time of event; `null` only when `event === 'cleared'`. */
-    goal: KodaXGoalState | null;
-    event: KodaXGoalEventType;
-}
-type KodaXSessionEntry = KodaXSessionMessageEntry | KodaXSessionCompactionEntry | KodaXSessionBranchSummaryEntry | KodaXSessionLabelEntry | KodaXSessionArchiveMarkerEntry | KodaXSessionRewindMarkerEntry | KodaXSessionClientNoticeEntry | KodaXSessionMemoryOutcomeDigestEntry | KodaXSessionMemoryReviewReceiptEntry | KodaXSessionGoalEntry;
-interface KodaXSessionArtifactLedgerEntry {
-    id: string;
-    kind: 'file_read' | 'file_modified' | 'file_created' | 'file_deleted' | 'path_scope' | 'search_scope' | 'command_scope' | 'check_result' | 'decision' | 'image_input' | 'tombstone';
-    sourceTool?: string;
-    action?: string;
-    target: string;
-    displayTarget?: string;
-    summary?: string;
-    sessionEntryId?: string;
-    timestamp: string;
-    metadata?: Record<string, KodaXJsonValue>;
-}
-interface KodaXCompactMemoryProgress {
-    completed: string[];
-    inProgress: string[];
-    blockers: string[];
-}
-interface KodaXCompactMemorySeed {
-    objective?: string;
-    constraints: string[];
-    progress: KodaXCompactMemoryProgress;
-    keyDecisions: string[];
-    nextSteps: string[];
-    keyContext: string[];
-    importantTargets: string[];
-    tombstones: string[];
-}
-interface KodaXSessionLineage {
-    version: 2;
-    activeEntryId: string | null;
-    entries: KodaXSessionEntry[];
-}
 
 interface MemoryContextIdentity {
     /** Explicit owner home for durable runtime state; never persisted in review envelopes. */
@@ -333,6 +177,25 @@ interface MemoryLifecycleOperationResult {
     readonly residualSourceRefs: readonly string[];
     readonly warnings: readonly string[];
 }
+interface MemoryRememberInput {
+    /** `correct` requires an exact managed Memory ref so the host never guesses a destructive target. */
+    readonly operation?: 'remember' | 'correct';
+    readonly statement: string;
+    readonly targetRefId?: string;
+    readonly claimKind?: MemoryClaimKind;
+    readonly claimKey?: string;
+    /** Stable evidence identity supplied by the user-facing host. */
+    readonly evidenceRef?: string;
+    /** Optional version guard for a target selected from a previously shown view. */
+    readonly expectedTargetFingerprint?: string;
+}
+interface MemoryRememberResult {
+    readonly status: 'remembered' | 'updated' | 'already_known' | 'needs_clarification' | 'needs_review' | 'rejected';
+    readonly changedRefIds: readonly string[];
+    readonly proposalIds: readonly string[];
+    readonly reason?: string;
+    readonly warnings: readonly string[];
+}
 interface MemoryCuratorInput {
     readonly includePrivate?: boolean;
     readonly includeSensitive?: boolean;
@@ -440,6 +303,8 @@ interface MemoryReviewDraftAction {
     readonly claimKey?: string;
     readonly actionSignature?: string;
     readonly preconditions?: string;
+    /** Host-bound version for an explicitly presented correction target. */
+    readonly authorizationTargetFingerprint?: string;
     readonly counterexamples?: readonly string[];
     readonly relationship?: 'same_claim' | 'condition_refinement' | 'conflict';
 }
@@ -467,12 +332,11 @@ interface MemoryReviewPersistenceDecision {
     readonly existingRefId?: string;
     readonly proposalId?: string;
 }
-type MemoryReviewRunner = (input: MemoryReviewModelInput) => Promise<MemoryReviewPlan>;
 interface MemoryController {
     listInbox(): Promise<readonly MemoryActionProposal[]>;
     showProposal(id: string): Promise<MemoryActionProposal | undefined>;
-    approveProposal(id: string, expectedFingerprints: Readonly<Record<string, string>>): Promise<MemoryApplyResult>;
-    rejectProposal(id: string, reason?: string): Promise<MemoryRejectResult>;
+    approveProposal(id: string, expectedFingerprints: Readonly<Record<string, string>>, expectedRevision?: string): Promise<MemoryApplyResult>;
+    rejectProposal(id: string, reason?: string, expectedRevision?: string): Promise<MemoryRejectResult>;
     listRefs(filter?: MemoryRefFilter): Promise<readonly MemoryItemRef[]>;
     readRef(ref: MemoryItemRef): Promise<MemoryBodySnapshot>;
     runCurator(input?: MemoryCuratorInput): Promise<MemoryGovernanceReport>;
@@ -490,29 +354,14 @@ interface MemoryController {
     listHostAppliedEpisodeProposalIds?(proposalIds: readonly string[]): Promise<readonly string[]>;
     reviewEpisode(digest: KodaXMemoryOutcomeDigest, signal?: AbortSignal): Promise<MemoryEpisodeReviewResult>;
     archiveRef(id: string): Promise<MemoryLifecycleOperationResult>;
-    forgetRef(id: string): Promise<MemoryLifecycleOperationResult>;
+    forgetRef(id: string, expectedBodyFingerprint?: string): Promise<MemoryLifecycleOperationResult>;
     purgeRef(id: string): Promise<MemoryLifecycleOperationResult>;
 }
-type MemoryEvent = {
-    readonly type: 'proposal.created';
-    readonly proposalId: string;
-} | {
-    readonly type: 'proposal.approved';
-    readonly proposalId: string;
-} | {
-    readonly type: 'proposal.rejected';
-    readonly proposalId: string;
-} | {
-    readonly type: 'curator.completed';
-    readonly reportId: string;
-} | {
-    readonly type: 'pack.selected';
-    readonly refIds: readonly string[];
-} | {
-    readonly type: 'review.completed';
-    readonly trigger: MemoryReviewTrigger;
-    readonly actionCount: number;
-};
+/** Additive management capability implemented by KodaX's default control plane. */
+interface MemoryManagementController extends MemoryController {
+    /** Applies an explicit, prompt-safe user/host instruction without a second approval ceremony. */
+    remember(input: MemoryRememberInput): Promise<MemoryRememberResult>;
+}
 
 type MemoryEvidenceGrade = 'authoritative' | 'verified' | 'corroborated' | 'observed' | 'inferred';
 interface MemoryEvidenceRef {
@@ -629,6 +478,7 @@ interface MemoryEpisodeOutcome {
     readonly summary: string;
     readonly evidence: readonly MemoryEvidenceRef[];
     readonly memoryIntent?: KodaXMemoryIntent;
+    readonly handledMemoryOperations?: readonly KodaXHandledMemoryOperation[];
 }
 type PersistedOutcomeDigest = KodaXMemoryOutcomeDigest;
 interface MemorySession {
@@ -647,6 +497,25 @@ interface MemorySession {
 interface MemoryAgent {
     startSession(input: MemorySessionInput): Promise<MemorySession>;
 }
+/** Additive durable-memory management facade implemented by createMemoryAgent. */
+interface MemoryManagementAgent extends MemoryAgent {
+    /** Lists accepted durable Memory with bodies, suitable for user-facing summaries. */
+    list(filter?: MemoryListFilter): Promise<readonly AcceptedMemoryView[]>;
+    /** Applies an explicit prompt-safe Memory instruction through the governed control plane. */
+    remember(input: MemoryRememberInput): Promise<MemoryRememberResult>;
+    /** Forgets one exact ref; callers should disambiguate before invoking it. */
+    forget(refId: string, expectedStorageFingerprint?: string): Promise<MemoryLifecycleOperationResult>;
+}
+/** User-facing accepted Memory; storageFingerprint versions the governed source file. */
+interface AcceptedMemoryView {
+    readonly ref: MemoryItemRef;
+    readonly handle: string;
+    readonly body: string;
+    readonly storageFingerprint: string;
+    readonly readAt: string;
+    readonly warnings: readonly string[];
+}
+type MemoryListFilter = Pick<MemoryRefFilter, 'query' | 'scopes'>;
 interface CreateMemoryAgentOptions {
     readonly controlPlane: MemoryController;
     readonly initialMemoryPack?: MemoryPack;
@@ -658,5 +527,8 @@ interface CreateMemoryAgentOptions {
     readonly onTrace?: (event: MemoryAgentTraceEvent) => void;
     readonly sourcePolicy?: MemorySourcePolicy;
 }
+interface CreateMemoryManagementAgentOptions extends Omit<CreateMemoryAgentOptions, 'controlPlane'> {
+    readonly controlPlane: MemoryManagementController;
+}
 
-export type { MemorySourcePolicy as A, CreateMemoryAgentOptions as C, KodaXSessionArtifactLedgerEntry as K, MemoryAgent as M, PersistedOutcomeDigest as P, KodaXSessionLineage as a, MemoryAgentTraceEvent as b, MemoryApplicability as c, MemoryContextIdentity as d, MemoryController as e, MemoryDecisionReceipt as f, MemoryEpisodeOutcome as g, MemoryEvent as h, MemoryEvidenceGrade as i, MemoryEvidenceRef as j, MemoryInterventionInput as k, MemoryInterventionTrigger as l, MemoryItemRef as m, MemoryObservation as n, MemoryObservationKind as o, MemoryPack as p, MemoryQueryInput as q, MemoryRecallCandidate as r, MemoryRecallInput as s, MemoryRecallRunner as t, MemoryRecallRunnerInput as u, MemoryReminder as v, MemoryReviewRunner as w, MemorySelectionMode as x, MemorySession as y, MemorySessionInput as z };
+export type { AcceptedMemoryView as A, CreateMemoryAgentOptions as C, KodaXHandledMemoryOperation as K, MemoryAgent as M, PersistedOutcomeDigest as P, CreateMemoryManagementAgentOptions as a, MemoryAgentTraceEvent as b, MemoryDecisionReceipt as c, MemoryEpisodeOutcome as d, MemoryEvidenceGrade as e, MemoryEvidenceRef as f, MemoryInterventionInput as g, MemoryInterventionTrigger as h, MemoryListFilter as i, MemoryManagementAgent as j, MemoryObservation as k, MemoryObservationKind as l, MemoryQueryInput as m, MemoryRecallCandidate as n, MemoryRecallInput as o, MemoryRecallRunner as p, MemoryRecallRunnerInput as q, MemoryReminder as r, MemorySelectionMode as s, MemorySession as t, MemorySessionInput as u, MemorySourcePolicy as v };

package/dist/types-chunks/{types.d-BbtGlKZu.d.ts → types.d-BSPlmJqf.d.ts}

@@ -216,16 +216,35 @@ interface SkillPathsConfig {
     learnedPath?: string;
     learnedArea?: LearnedSkillDiscoveryConfig;
 }
-interface LearnedSkillDiscoveryConfig {
+interface LearnedSkillDiscoveryScope {
+    readonly configHomeHash: string;
+    readonly tenantHash: string;
+    readonly projectHash: string;
+}
+interface LearnedSkillDiscoveryConfigBase {
     readonly rootDir: string;
-    readonly expectedScope: {
-        readonly configHomeHash: string;
-        readonly tenantHash: string;
-        readonly projectHash: string;
-    };
+    /** Additional identity-specific Learned Areas, in fallback precedence order. */
+    readonly additionalRootDirs?: readonly string[];
     readonly testingBindings?: Readonly<Record<string, string>>;
     readonly now?: string;
 }
+interface LearnedSkillDiscoveryConfig extends LearnedSkillDiscoveryConfigBase {
+    /**
+     * Primary identity scope. Kept required so existing consumers can both
+     * construct and read the original public configuration shape unchanged.
+     */
+    readonly expectedScope: LearnedSkillDiscoveryScope;
+    /**
+     * One or more identity scopes paired with rootDir/additionalRootDirs.
+     * Multi-scope support resolves the non-deterministic divergence between
+     * `remote:*` (git remote available) and `local:*` (git remote unavailable)
+     * project identities within the same repository.
+     */
+    readonly expectedScopes?: readonly [
+        LearnedSkillDiscoveryScope,
+        ...LearnedSkillDiscoveryScope[]
+    ];
+}
 /**
  * Get default skill discovery paths
  *

package/dist/types-chunks/{types.d-DIXZFauU.d.ts → types.d-Bo4fyMLu.d.ts}

@@ -1,4 +1,4 @@
-import { bM as KodaXInputArtifact } from './controller.d-CYNuR2n9.js';
+import { a$ as KodaXInputArtifact } from './controller.d-Dzxz22X-.js';
 import { T as KodaXTaskResultMetadata } from './types.d-CgrXrFrq.js';
 
 /**

package/dist/types-chunks/{types.d-DKs4tfSd.d.ts → types.d-Ch3BD97c.d.ts}

@@ -1,8 +1,8 @@
 import { aa as KodaXWireReasoningEffort, a2 as KodaXToolDefinition, a4 as KodaXToolResultContentItem, k as KodaXMessage } from './types.d-CgrXrFrq.js';
 import { K as KodaXBaseProvider } from './base.d-DxG0m09Z.js';
 import { C as CapabilityKind, a as CapabilityProvider } from './capability.d-K664nHOS.js';
-import { bO as KodaXJsonValue, bC as KodaXExtensionSessionRecord, bE as KodaXExtensionStore } from './controller.d-CYNuR2n9.js';
-import { aQ as KodaXToolExecutionContext, by as ToolSideEffect } from './bash-prefix-extractor.d-CJM7OY-L.js';
+import { Y as KodaXJsonValue, Q as KodaXExtensionSessionRecord, S as KodaXExtensionStore } from './types.d-DlLBRqZ9.js';
+import { aT as KodaXToolExecutionContext, bB as ToolSideEffect } from './bash-prefix-extractor.d-BnZQDirs.js';
 
 /**
  * KodaX Constructed-World types (FEATURE_087, v0.7.28).