cognitive-core 0.0.2 → 0.1.2

package/dist/types/meta.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Meta Memory Types
+ *
+ * Types for meta-learning - learning about learning itself
+ * Tracks routing decisions, memory effectiveness, and execution patterns
+ */
+/**
+ * MetaObservation - Records for learning about learning
+ * Captures what happened during task execution for later analysis
+ */
+export interface MetaObservation {
+    id: string;
+    trajectoryId: string;
+    routing: RoutingObservation;
+    memoryUsage: MemoryUsageObservation;
+    execution: ExecutionObservation;
+    outcome: OutcomeObservation;
+    lessons: LessonsLearned;
+    timestamp: Date;
+}
+/**
+ * Observation about the routing decision
+ */
+export interface RoutingObservation {
+    decision: RoutingDecisionType;
+    confidence: number;
+    reasoning: string;
+}
+export type RoutingDecisionType = 'adapt' | 'direct' | 'explore' | 'fallback';
+/**
+ * Observation about memory retrieval effectiveness
+ */
+export interface MemoryUsageObservation {
+    experiencesRetrieved: number;
+    playbooksApplied: string[];
+    retrievalQuality: RetrievalQuality;
+}
+export type RetrievalQuality = 'helpful' | 'neutral' | 'misleading';
+/**
+ * Observation about the execution path
+ */
+export interface ExecutionObservation {
+    decompositionUsed: boolean;
+    refinementIterations: number;
+    backtrackingOccurred: boolean;
+    toolsUsed: string[];
+}
+/**
+ * Observation about the outcome
+ */
+export interface OutcomeObservation {
+    success: boolean;
+    quality: OutcomeQuality;
+    effortActual: number;
+    effortEstimate: number;
+}
+export type OutcomeQuality = 'excellent' | 'good' | 'acceptable' | 'poor';
+/**
+ * Lessons learned from the execution
+ */
+export interface LessonsLearned {
+    whatWorked: string[];
+    whatFailed: string[];
+    suggestions: string[];
+}
+/**
+ * MetaStrategy - Learned patterns about learning itself
+ * Used to adjust routing and retrieval based on context
+ */
+export interface MetaStrategy {
+    id: string;
+    name: string;
+    condition: MetaStrategyCondition;
+    adjustment: MetaStrategyAdjustment;
+    applicationCount: number;
+    successRate: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Conditions for applying a meta-strategy
+ */
+export interface MetaStrategyCondition {
+    taskCharacteristics: string[];
+    memoryState: string[];
+}
+/**
+ * Adjustments to make when meta-strategy applies
+ */
+export interface MetaStrategyAdjustment {
+    routingBias: Partial<Record<RoutingDecisionType, number>>;
+    retrievalModification: string;
+    executionHint: string;
+}
+/**
+ * Analysis of routing effectiveness
+ */
+export interface RoutingAnalysis {
+    byDecision: Record<string, {
+        total: number;
+        successful: number;
+    }>;
+    recommendations: string[];
+}
+/**
+ * Analysis of retrieval quality
+ */
+export interface RetrievalAnalysis {
+    helpfulPatterns: string[];
+    misleadingPatterns: string[];
+    recommendations: string[];
+}
+/**
+ * Statistics about meta-learning
+ */
+export interface MetaStats {
+    totalObservations: number;
+    totalStrategies: number;
+    observationsByRouting: Record<RoutingDecisionType, number>;
+    averageSuccessRate: number;
+    recentTrend: 'improving' | 'stable' | 'declining';
+}
+/**
+ * Context for meta-learning queries
+ */
+export interface MetaContext {
+    taskCharacteristics: string[];
+    memoryState: string[];
+}
+/**
+ * Create a new meta-observation with defaults
+ */
+export declare function createMetaObservation(input: Partial<MetaObservation> & {
+    trajectoryId: string;
+    routing: RoutingObservation;
+    outcome: OutcomeObservation;
+}): MetaObservation;
+/**
+ * Create a new meta-strategy with defaults
+ */
+export declare function createMetaStrategy(input: Partial<MetaStrategy> & {
+    name: string;
+    condition: MetaStrategyCondition;
+    adjustment: MetaStrategyAdjustment;
+}): MetaStrategy;
+//# sourceMappingURL=meta.d.ts.map

package/dist/types/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/types/meta.ts"],"names":[],"mappings":"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"}

package/dist/types/meta.js

@@ -0,0 +1,51 @@
+/**
+ * Meta Memory Types
+ *
+ * Types for meta-learning - learning about learning itself
+ * Tracks routing decisions, memory effectiveness, and execution patterns
+ */
+/**
+ * Create a new meta-observation with defaults
+ */
+export function createMetaObservation(input) {
+    return {
+        id: input.id ?? `meta-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+        trajectoryId: input.trajectoryId,
+        routing: input.routing,
+        memoryUsage: input.memoryUsage ?? {
+            experiencesRetrieved: 0,
+            playbooksApplied: [],
+            retrievalQuality: 'neutral',
+        },
+        execution: input.execution ?? {
+            decompositionUsed: false,
+            refinementIterations: 0,
+            backtrackingOccurred: false,
+            toolsUsed: [],
+        },
+        outcome: input.outcome,
+        lessons: input.lessons ?? {
+            whatWorked: [],
+            whatFailed: [],
+            suggestions: [],
+        },
+        timestamp: input.timestamp ?? new Date(),
+    };
+}
+/**
+ * Create a new meta-strategy with defaults
+ */
+export function createMetaStrategy(input) {
+    const now = new Date();
+    return {
+        id: input.id ?? `meta-strategy-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+        name: input.name,
+        condition: input.condition,
+        adjustment: input.adjustment,
+        applicationCount: input.applicationCount ?? 0,
+        successRate: input.successRate ?? 0,
+        createdAt: input.createdAt ?? now,
+        updatedAt: input.updatedAt ?? now,
+    };
+}
+//# sourceMappingURL=meta.js.map

package/dist/types/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/types/meta.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4JH;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAIC;IAED,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QAC9E,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI;YAChC,oBAAoB,EAAE,CAAC;YACvB,gBAAgB,EAAE,EAAE;YACpB,gBAAgB,EAAE,SAAS;SAC5B;QACD,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI;YAC5B,iBAAiB,EAAE,KAAK;YACxB,oBAAoB,EAAE,CAAC;YACvB,oBAAoB,EAAE,KAAK;YAC3B,SAAS,EAAE,EAAE;SACd;QACD,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI;YACxB,UAAU,EAAE,EAAE;YACd,UAAU,EAAE,EAAE;YACd,WAAW,EAAE,EAAE;SAChB;QACD,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE;KACzC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAIC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,iBAAiB,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QACvF,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,IAAI,CAAC;QAC7C,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,CAAC;QACnC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG;QACjC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG;KAClC,CAAC;AACJ,CAAC"}

package/dist/types/outcome.d.ts

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+/**
+ * Outcome - The result of a task attempt
+ */
+export declare const OutcomeSchema: z.ZodObject<{
+    /** Whether the task was completed successfully */
+    success: z.ZodBoolean;
+    /** Partial progress score (0.0-1.0) */
+    partialScore: z.ZodDefault<z.ZodNumber>;
+    /** Error information if failed */
+    errorInfo: z.ZodOptional<z.ZodString>;
+    /** Detailed verification results */
+    verificationDetails: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** The final solution/output */
+    solution: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    partialScore: number;
+    verificationDetails: Record<string, unknown>;
+    errorInfo?: string | undefined;
+    solution?: unknown;
+}, {
+    success: boolean;
+    partialScore?: number | undefined;
+    errorInfo?: string | undefined;
+    verificationDetails?: Record<string, unknown> | undefined;
+    solution?: unknown;
+}>;
+export type Outcome = z.infer<typeof OutcomeSchema>;
+/**
+ * Create a successful outcome
+ */
+export declare function successOutcome(solution: unknown, details?: Record<string, unknown>): Outcome;
+/**
+ * Create a failed outcome
+ */
+export declare function failureOutcome(errorInfo: string, partialScore?: number, details?: Record<string, unknown>): Outcome;
+/**
+ * Create a partial outcome
+ */
+export declare function partialOutcome(partialScore: number, solution: unknown, details?: Record<string, unknown>): Outcome;
+//# sourceMappingURL=outcome.d.ts.map

package/dist/types/outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.d.ts","sourceRoot":"","sources":["../../src/types/outcome.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,kDAAkD;;IAElD,uCAAuC;;IAEvC,kCAAkC;;IAElC,oCAAoC;;IAEpC,gCAAgC;;;;;;;;;;;;;;EAEhC,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAOT;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,YAAY,SAAI,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAOT;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAOT"}

package/dist/types/outcome.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+/**
+ * Outcome - The result of a task attempt
+ */
+export const OutcomeSchema = z.object({
+    /** Whether the task was completed successfully */
+    success: z.boolean(),
+    /** Partial progress score (0.0-1.0) */
+    partialScore: z.number().min(0).max(1).default(0),
+    /** Error information if failed */
+    errorInfo: z.string().optional(),
+    /** Detailed verification results */
+    verificationDetails: z.record(z.unknown()).default({}),
+    /** The final solution/output */
+    solution: z.unknown().optional(),
+});
+/**
+ * Create a successful outcome
+ */
+export function successOutcome(solution, details) {
+    return OutcomeSchema.parse({
+        success: true,
+        partialScore: 1.0,
+        solution,
+        verificationDetails: details ?? {},
+    });
+}
+/**
+ * Create a failed outcome
+ */
+export function failureOutcome(errorInfo, partialScore = 0, details) {
+    return OutcomeSchema.parse({
+        success: false,
+        partialScore,
+        errorInfo,
+        verificationDetails: details ?? {},
+    });
+}
+/**
+ * Create a partial outcome
+ */
+export function partialOutcome(partialScore, solution, details) {
+    return OutcomeSchema.parse({
+        success: false,
+        partialScore,
+        solution,
+        verificationDetails: details ?? {},
+    });
+}
+//# sourceMappingURL=outcome.js.map

package/dist/types/outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.js","sourceRoot":"","sources":["../../src/types/outcome.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,kDAAkD;IAClD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,uCAAuC;IACvC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,kCAAkC;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,oCAAoC;IACpC,mBAAmB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACtD,gCAAgC;IAChC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAiB,EACjB,OAAiC;IAEjC,OAAO,aAAa,CAAC,KAAK,CAAC;QACzB,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,GAAG;QACjB,QAAQ;QACR,mBAAmB,EAAE,OAAO,IAAI,EAAE;KACnC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,YAAY,GAAG,CAAC,EAChB,OAAiC;IAEjC,OAAO,aAAa,CAAC,KAAK,CAAC;QACzB,OAAO,EAAE,KAAK;QACd,YAAY;QACZ,SAAS;QACT,mBAAmB,EAAE,OAAO,IAAI,EAAE;KACnC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,YAAoB,EACpB,QAAiB,EACjB,OAAiC;IAEjC,OAAO,aAAa,CAAC,KAAK,CAAC;QACzB,OAAO,EAAE,KAAK;QACd,YAAY;QACZ,QAAQ;QACR,mBAAmB,EAAE,OAAO,IAAI,EAAE;KACnC,CAAC,CAAC;AACL,CAAC"}

package/dist/types/playbook.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Playbook Types
+ *
+ * Playbook - Adaptive guidance that evolves with experience
+ * Merges ArcMemo strategies with Claudeception skills + Voyager evolution
+ */
+/**
+ * Playbook - The core learning unit that replaces Strategy + Skill
+ * Provides adaptive guidance that evolves based on usage outcomes
+ */
+export interface Playbook {
+    id: string;
+    name: string;
+    applicability: PlaybookApplicability;
+    guidance: PlaybookGuidance;
+    verification: PlaybookVerification;
+    evolution: PlaybookEvolution;
+    provenance?: PlaybookProvenance;
+    confidence: number;
+    complexity: PlaybookComplexity;
+    estimatedEffort: number;
+    embedding?: number[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * When to apply this playbook
+ */
+export interface PlaybookApplicability {
+    situations: string[];
+    triggers: string[];
+    antiPatterns: string[];
+    domains: string[];
+}
+/**
+ * What to do when the playbook applies
+ */
+export interface PlaybookGuidance {
+    strategy: string;
+    tactics: string[];
+    steps?: string[];
+    codeExample?: string;
+}
+/**
+ * How to verify the playbook worked
+ */
+export interface PlaybookVerification {
+    successIndicators: string[];
+    failureIndicators: string[];
+    rollbackStrategy?: string;
+}
+/**
+ * Provenance tracking - where a playbook came from
+ */
+export type PlaybookOrigin = 'extracted' | 'curated' | 'imported' | 'manual';
+export interface PlaybookProvenance {
+    /** How the playbook was created */
+    origin: PlaybookOrigin;
+    /** For curated: relative path to source file (e.g. "playbooks/typescript-debugging.json") */
+    sourceFile?: string;
+    /** For imported: identifier of the source (e.g. "dash-agent", "community-pack") */
+    importedFrom?: string;
+    /** For curated: who authored it */
+    curatedBy?: string;
+    /** When this provenance was recorded */
+    recordedAt: Date;
+}
+/**
+ * Evolution tracking for Voyager-style learning
+ */
+export interface PlaybookEvolution {
+    version: string;
+    createdFrom: string[];
+    failures: FailureRecord[];
+    refinements: Refinement[];
+    successCount: number;
+    failureCount: number;
+    lastUsed?: Date;
+}
+/**
+ * Record of a failure when applying the playbook
+ */
+export interface FailureRecord {
+    trajectoryId: string;
+    context: string;
+    failureMode: string;
+    timestamp: Date;
+}
+/**
+ * Context-specific refinement to the playbook
+ */
+export interface Refinement {
+    context: string;
+    addition: string;
+    source: 'failure' | 'success' | 'manual';
+    addedAt: Date;
+}
+export type PlaybookComplexity = 'simple' | 'moderate' | 'complex';
+/**
+ * Create a new playbook with defaults
+ */
+export declare function createPlaybook(input: Partial<Playbook> & {
+    name: string;
+    applicability: PlaybookApplicability;
+    guidance: PlaybookGuidance;
+}): Playbook;
+/**
+ * Bump playbook version
+ */
+export declare function bumpPlaybookVersion(playbook: Playbook, type?: 'major' | 'minor' | 'patch'): string;
+/**
+ * Calculate playbook success rate
+ */
+export declare function getPlaybookSuccessRate(playbook: Playbook): number;
+/**
+ * Check if playbook has been used enough for reliable statistics
+ */
+export declare function hasReliableStats(playbook: Playbook, minUses?: number): boolean;
+//# sourceMappingURL=playbook.d.ts.map

package/dist/types/playbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook.d.ts","sourceRoot":"","sources":["../../src/types/playbook.ts"],"names":[],"mappings":"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"}

package/dist/types/playbook.js

@@ -0,0 +1,71 @@
+/**
+ * Playbook Types
+ *
+ * Playbook - Adaptive guidance that evolves with experience
+ * Merges ArcMemo strategies with Claudeception skills + Voyager evolution
+ */
+/**
+ * Create a new playbook with defaults
+ */
+export function createPlaybook(input) {
+    const now = new Date();
+    return {
+        id: input.id ?? `playbook-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+        name: input.name,
+        applicability: input.applicability,
+        guidance: input.guidance,
+        verification: input.verification ?? {
+            successIndicators: [],
+            failureIndicators: [],
+        },
+        evolution: input.evolution ?? {
+            version: '1.0.0',
+            createdFrom: [],
+            failures: [],
+            refinements: [],
+            successCount: 0,
+            failureCount: 0,
+        },
+        provenance: input.provenance ?? {
+            origin: 'extracted',
+            recordedAt: now,
+        },
+        confidence: input.confidence ?? 0.3, // Start with low confidence
+        complexity: input.complexity ?? 'moderate',
+        estimatedEffort: input.estimatedEffort ?? 3,
+        embedding: input.embedding,
+        createdAt: input.createdAt ?? now,
+        updatedAt: input.updatedAt ?? now,
+    };
+}
+/**
+ * Bump playbook version
+ */
+export function bumpPlaybookVersion(playbook, type = 'patch') {
+    const [major, minor, patch] = playbook.evolution.version.split('.').map(Number);
+    switch (type) {
+        case 'major':
+            return `${major + 1}.0.0`;
+        case 'minor':
+            return `${major}.${minor + 1}.0`;
+        case 'patch':
+        default:
+            return `${major}.${minor}.${patch + 1}`;
+    }
+}
+/**
+ * Calculate playbook success rate
+ */
+export function getPlaybookSuccessRate(playbook) {
+    const total = playbook.evolution.successCount + playbook.evolution.failureCount;
+    if (total === 0)
+        return 0;
+    return playbook.evolution.successCount / total;
+}
+/**
+ * Check if playbook has been used enough for reliable statistics
+ */
+export function hasReliableStats(playbook, minUses = 3) {
+    return playbook.evolution.successCount + playbook.evolution.failureCount >= minUses;
+}
+//# sourceMappingURL=playbook.js.map

package/dist/types/playbook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook.js","sourceRoot":"","sources":["../../src/types/playbook.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoHH;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,KAIC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QAClF,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI;YAClC,iBAAiB,EAAE,EAAE;YACrB,iBAAiB,EAAE,EAAE;SACtB;QACD,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI;YAC5B,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,EAAE;YACf,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,EAAE;YACf,YAAY,EAAE,CAAC;YACf,YAAY,EAAE,CAAC;SAChB;QACD,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI;YAC9B,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,GAAG;SAChB;QACD,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,GAAG,EAAE,4BAA4B;QACjE,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,UAAU;QAC1C,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,CAAC;QAC3C,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG;QACjC,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,GAAG;KAClC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAkB,EAClB,OAAoC,OAAO;IAE3C,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO;YACV,OAAO,GAAG,KAAK,GAAG,CAAC,MAAM,CAAC;QAC5B,KAAK,OAAO;YACV,OAAO,GAAG,KAAK,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC;QACnC,KAAK,OAAO,CAAC;QACb;YACE,OAAO,GAAG,KAAK,IAAI,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;IAC5C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAkB;IACvD,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,YAAY,GAAG,QAAQ,CAAC,SAAS,CAAC,YAAY,CAAC;IAChF,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,QAAQ,CAAC,SAAS,CAAC,YAAY,GAAG,KAAK,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAkB,EAAE,UAAkB,CAAC;IACtE,OAAO,QAAQ,CAAC,SAAS,CAAC,YAAY,GAAG,QAAQ,CAAC,SAAS,CAAC,YAAY,IAAI,OAAO,CAAC;AACtF,CAAC"}

package/dist/types/step.d.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+/**
+ * Step - A single action in a trajectory
+ * Follows ReAct-style (Reasoning + Acting) pattern
+ */
+export declare const StepSchema: z.ZodObject<{
+    /** Optional reasoning/thought before action */
+    thought: z.ZodOptional<z.ZodString>;
+    /** The action taken */
+    action: z.ZodString;
+    /** Result/observation from the action */
+    observation: z.ZodString;
+    /** Timestamp when step was executed */
+    timestamp: z.ZodDefault<z.ZodDate>;
+    /** Additional metadata */
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** Credit attribution score (0-1), assigned during analysis */
+    attributionScore: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    metadata: Record<string, unknown>;
+    action: string;
+    observation: string;
+    timestamp: Date;
+    thought?: string | undefined;
+    attributionScore?: number | undefined;
+}, {
+    action: string;
+    observation: string;
+    metadata?: Record<string, unknown> | undefined;
+    thought?: string | undefined;
+    timestamp?: Date | undefined;
+    attributionScore?: number | undefined;
+}>;
+export type Step = z.infer<typeof StepSchema>;
+/**
+ * Create a new step
+ */
+export declare function createStep(params: {
+    thought?: string;
+    action: string;
+    observation: string;
+    metadata?: Record<string, unknown>;
+}): Step;
+//# sourceMappingURL=step.d.ts.map

package/dist/types/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../src/types/step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,UAAU;IACrB,+CAA+C;;IAE/C,uBAAuB;;IAEvB,yCAAyC;;IAEzC,uCAAuC;;IAEvC,0BAA0B;;IAE1B,+DAA+D;;;;;;;;;;;;;;;;EAE/D,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,IAAI,CAQP"}

package/dist/types/step.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+/**
+ * Step - A single action in a trajectory
+ * Follows ReAct-style (Reasoning + Acting) pattern
+ */
+export const StepSchema = z.object({
+    /** Optional reasoning/thought before action */
+    thought: z.string().optional(),
+    /** The action taken */
+    action: z.string(),
+    /** Result/observation from the action */
+    observation: z.string(),
+    /** Timestamp when step was executed */
+    timestamp: z.date().default(() => new Date()),
+    /** Additional metadata */
+    metadata: z.record(z.unknown()).default({}),
+    /** Credit attribution score (0-1), assigned during analysis */
+    attributionScore: z.number().min(0).max(1).optional(),
+});
+/**
+ * Create a new step
+ */
+export function createStep(params) {
+    return StepSchema.parse({
+        thought: params.thought,
+        action: params.action,
+        observation: params.observation,
+        timestamp: new Date(),
+        metadata: params.metadata ?? {},
+    });
+}
+//# sourceMappingURL=step.js.map

package/dist/types/step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.js","sourceRoot":"","sources":["../../src/types/step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,+CAA+C;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,uBAAuB;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,yCAAyC;IACzC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,uCAAuC;IACvC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;IAC7C,0BAA0B;IAC1B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3C,+DAA+D;IAC/D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAK1B;IACC,OAAO,UAAU,CAAC,KAAK,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;KAChC,CAAC,CAAC;AACL,CAAC"}