@soleri/core 9.0.4 → 9.2.0

package/dist/operator/operator-signals.js.map

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

package/dist/operator/operator-types.d.ts

@@ -0,0 +1,360 @@
+/**
+ * Operator Profile Types — type foundation for the Operator Profile module.
+ *
+ * Defines signals, profile sections, synthesis checks, and history
+ * for personality learning and adaptation.
+ */
+/** All recognized signal types emitted during operator interaction. */
+export declare enum SignalType {
+    CommandStyle = "command_style",
+    WorkRhythm = "work_rhythm",
+    ToolPreference = "tool_preference",
+    SessionDepth = "session_depth",
+    DomainExpertise = "domain_expertise",
+    Correction = "correction",
+    Frustration = "frustration",
+    PersonalShare = "personal_share",
+    CommunicationPref = "communication_pref",
+    ReactionToOutput = "reaction_to_output"
+}
+/** Data for CommandStyle signals — how the operator phrases requests. */
+export interface CommandStyleData {
+    style: 'terse' | 'verbose' | 'conversational' | 'directive';
+    /** Raw input snippet that evidences this style. */
+    snippet: string;
+}
+/** Data for WorkRhythm signals — cadence and session patterns. */
+export interface WorkRhythmData {
+    pattern: 'burst' | 'steady' | 'exploratory' | 'deep-focus';
+    /** Duration in minutes of the observed rhythm. */
+    durationMinutes: number;
+    /** Number of tasks completed in the observed window. */
+    taskCount: number;
+}
+/** Data for ToolPreference signals — which tools the operator favors. */
+export interface ToolPreferenceData {
+    toolName: string;
+    action: 'used' | 'avoided' | 'requested' | 'dismissed';
+    /** How many times this preference was observed. */
+    frequency: number;
+}
+/** Data for SessionDepth signals — how deep sessions tend to go. */
+export interface SessionDepthData {
+    depth: 'shallow' | 'moderate' | 'deep' | 'marathon';
+    /** Number of messages in the session. */
+    messageCount: number;
+    /** Duration in minutes. */
+    durationMinutes: number;
+}
+/** Data for DomainExpertise signals — areas of operator expertise. */
+export interface DomainExpertiseData {
+    domain: string;
+    level: 'novice' | 'intermediate' | 'advanced' | 'expert';
+    /** Evidence that led to this assessment. */
+    evidence: string;
+}
+/** Data for Correction signals — when the operator corrects agent output. */
+export interface CorrectionData {
+    /** What the agent produced. */
+    original: string;
+    /** What the operator wanted instead. */
+    corrected: string;
+    /** Category of the correction. */
+    category: 'factual' | 'style' | 'approach' | 'scope' | 'tone';
+}
+/** Data for Frustration signals — detected operator frustration. */
+export interface FrustrationData {
+    level: 'mild' | 'moderate' | 'high';
+    /** Trigger phrase or context. */
+    trigger: string;
+    /** What the agent was doing when frustration was detected. */
+    context: string;
+}
+/** Data for PersonalShare signals — operator shares personal info. */
+export interface PersonalShareData {
+    category: 'background' | 'preference' | 'philosophy' | 'anecdote';
+    content: string;
+    /** Whether the operator explicitly shared or it was inferred. */
+    explicit: boolean;
+}
+/** Data for CommunicationPref signals — how the operator prefers responses. */
+export interface CommunicationPrefData {
+    preference: 'concise' | 'detailed' | 'structured' | 'casual' | 'formal';
+    /** Specific aspect: response length, formatting, tone, etc. */
+    aspect: 'length' | 'format' | 'tone' | 'detail-level';
+}
+/** Data for ReactionToOutput signals — how the operator responds to agent output. */
+export interface ReactionToOutputData {
+    reaction: 'positive' | 'negative' | 'neutral' | 'mixed';
+    /** What aspect of the output prompted the reaction. */
+    aspect: 'accuracy' | 'style' | 'completeness' | 'speed' | 'approach';
+    /** Optional feedback snippet. */
+    feedback?: string;
+}
+/** Maps each SignalType to its typed data payload. */
+export interface SignalDataMap {
+    [SignalType.CommandStyle]: CommandStyleData;
+    [SignalType.WorkRhythm]: WorkRhythmData;
+    [SignalType.ToolPreference]: ToolPreferenceData;
+    [SignalType.SessionDepth]: SessionDepthData;
+    [SignalType.DomainExpertise]: DomainExpertiseData;
+    [SignalType.Correction]: CorrectionData;
+    [SignalType.Frustration]: FrustrationData;
+    [SignalType.PersonalShare]: PersonalShareData;
+    [SignalType.CommunicationPref]: CommunicationPrefData;
+    [SignalType.ReactionToOutput]: ReactionToOutputData;
+}
+/** Base fields shared by all operator signals. */
+interface OperatorSignalBase {
+    /** Unique signal ID. */
+    id: string;
+    /** ISO 8601 timestamp when the signal was captured. */
+    timestamp: string;
+    /** Session ID where the signal was observed. */
+    sessionId: string;
+    /** Confidence in the signal detection (0.0 - 1.0). */
+    confidence: number;
+    /** Optional source context (e.g., message index, tool call). */
+    source?: string;
+}
+/** Type-safe operator signal — discriminated on `signalType`. */
+export type OperatorSignal = {
+    [K in SignalType]: OperatorSignalBase & {
+        signalType: K;
+        data: SignalDataMap[K];
+    };
+}[SignalType];
+/** Evidence record attached to profile section entries. */
+export interface ProfileEvidence {
+    /** Signal ID that contributed to this evidence. */
+    signalId: string;
+    /** When the evidence was recorded. */
+    timestamp: string;
+    /** Confidence of the originating signal. */
+    confidence: number;
+    /** Short description of what was observed. */
+    summary: string;
+}
+/** Identity section — who the operator is. */
+export interface IdentitySection {
+    /** Operator's professional background. */
+    background: string;
+    /** Current role or title. */
+    role: string;
+    /** Guiding philosophy or values. */
+    philosophy: string;
+    /** Evidence trail for identity inferences. */
+    evidence: ProfileEvidence[];
+}
+/** A single cognitive pattern observed in the operator. */
+export interface CognitivePattern {
+    /** Name of the pattern (e.g., "visual-first-thinker"). */
+    name: string;
+    /** Description of the observed behavior. */
+    description: string;
+    /** How strongly this pattern is established (0.0 - 1.0). */
+    strength: number;
+}
+/** A derivation — something inferred from observed patterns. */
+export interface CognitiveDerivation {
+    /** What was derived. */
+    insight: string;
+    /** Which patterns led to this derivation. */
+    sourcePatterns: string[];
+    /** Confidence in the derivation (0.0 - 1.0). */
+    confidence: number;
+}
+/** Cognition section — how the operator thinks. */
+export interface CognitionSection {
+    /** Observed cognitive patterns. */
+    patterns: CognitivePattern[];
+    /** Inferences derived from pattern combinations. */
+    derivations: CognitiveDerivation[];
+    /** Evidence trail. */
+    evidence: ProfileEvidence[];
+}
+/** Adaptation rule for communication. */
+export interface CommunicationAdaptationRule {
+    /** Condition that triggers the adaptation. */
+    when: string;
+    /** How the agent should adapt. */
+    then: string;
+    /** Source: observed from signals or reported by operator. */
+    source: 'observed' | 'reported';
+}
+/** Communication section — how the operator prefers to communicate. */
+export interface CommunicationSection {
+    /** Overall communication style. */
+    style: 'concise' | 'detailed' | 'structured' | 'casual' | 'formal' | 'mixed';
+    /** Words or phrases the operator frequently uses. */
+    signalWords: string[];
+    /** Formality level (0.0 casual - 1.0 formal). */
+    formality: number;
+    /** Patience level (0.0 impatient - 1.0 patient). */
+    patience: number;
+    /** Rules for adapting agent communication. */
+    adaptationRules: CommunicationAdaptationRule[];
+}
+/** A working rule the agent should follow for this operator. */
+export interface WorkingRule {
+    /** The rule statement. */
+    rule: string;
+    /** Where the rule came from. */
+    source: 'observed' | 'reported';
+    /** How many times this rule has been reinforced. */
+    reinforcements: number;
+    /** When the rule was first established. */
+    firstSeen: string;
+    /** When the rule was last reinforced. */
+    lastSeen: string;
+}
+/** Working rules section — operator-specific behavioral rules. */
+export interface WorkingRulesSection {
+    rules: WorkingRule[];
+}
+/** Trust builder or breaker event. */
+export interface TrustEvent {
+    /** Description of the event. */
+    event: string;
+    /** Impact on trust (-1.0 to 1.0). */
+    impact: number;
+    /** When it happened. */
+    timestamp: string;
+}
+/** Trust model section — the operator's trust relationship with the agent. */
+export interface TrustModelSection {
+    /** Overall trust level label. */
+    level: 'new' | 'developing' | 'established' | 'deep';
+    /** Events that built trust. */
+    builders: TrustEvent[];
+    /** Events that eroded trust. */
+    breakers: TrustEvent[];
+    /** Numeric trust level (0.0 - 1.0). */
+    currentLevel: number;
+}
+/** A single taste profile entry. */
+export interface TasteEntry {
+    /** Category of taste (e.g., "code-style", "design", "tooling"). */
+    category: string;
+    /** The specific taste or preference. */
+    content: string;
+    /** How this taste affects work output. */
+    workImplication: string;
+    /** Evidence trail. */
+    evidence: ProfileEvidence[];
+}
+/** Taste profile section — operator's aesthetic and stylistic preferences. */
+export interface TasteProfileSection {
+    entries: TasteEntry[];
+}
+/** A growth edge — area where the operator is developing. */
+export interface GrowthEdge {
+    /** The area of growth. */
+    area: string;
+    /** Description of the growth edge. */
+    description: string;
+    /** Current progress assessment. */
+    progress: 'emerging' | 'developing' | 'maturing';
+}
+/** Growth edges section — areas the operator is developing in. */
+export interface GrowthEdgesSection {
+    /** Growth edges observed by the agent. */
+    observed: GrowthEdge[];
+    /** Growth edges the operator has mentioned themselves. */
+    selfReported: GrowthEdge[];
+}
+/** A known tool in the operator's technical context. */
+export interface TechnicalTool {
+    /** Tool name. */
+    name: string;
+    /** Proficiency level. */
+    proficiency: 'beginner' | 'intermediate' | 'advanced' | 'expert';
+    /** How frequently the operator uses this tool. */
+    frequency: 'rare' | 'occasional' | 'regular' | 'daily';
+}
+/** A blind spot in the operator's technical knowledge. */
+export interface TechnicalBlindSpot {
+    /** Area of the blind spot. */
+    area: string;
+    /** Description. */
+    description: string;
+    /** How the agent should handle this blind spot. */
+    mitigation: string;
+}
+/** Technical context section — operator's technical environment. */
+export interface TechnicalContextSection {
+    /** Domains the operator works in. */
+    domains: string[];
+    /** Tools the operator uses. */
+    tools: TechnicalTool[];
+    /** Known technical blind spots. */
+    blindSpots: TechnicalBlindSpot[];
+}
+/** Union of all profile section types. */
+export type ProfileSection = IdentitySection | CognitionSection | CommunicationSection | WorkingRulesSection | TrustModelSection | TasteProfileSection | GrowthEdgesSection | TechnicalContextSection;
+/** Profile section keys. */
+export type ProfileSectionKey = 'identity' | 'cognition' | 'communication' | 'workingRules' | 'trustModel' | 'tasteProfile' | 'growthEdges' | 'technicalContext';
+/** Complete operator profile — composed of all sections plus metadata. */
+export interface OperatorProfile {
+    /** Unique profile ID. */
+    id: string;
+    /** Operator identifier (e.g., username, session owner). */
+    operatorId: string;
+    /** Profile format version for migration support. */
+    version: number;
+    identity: IdentitySection;
+    cognition: CognitionSection;
+    communication: CommunicationSection;
+    workingRules: WorkingRulesSection;
+    trustModel: TrustModelSection;
+    tasteProfile: TasteProfileSection;
+    growthEdges: GrowthEdgesSection;
+    technicalContext: TechnicalContextSection;
+    /** Total number of sessions that contributed to this profile. */
+    sessionCount: number;
+    /** ISO 8601 timestamp of the last synthesis pass. */
+    lastSynthesis: string | null;
+    /** ISO 8601 timestamp when the profile was created. */
+    createdAt: string;
+    /** ISO 8601 timestamp of the last update. */
+    updatedAt: string;
+}
+/** Result of checking whether a synthesis pass is needed. */
+export interface SynthesisCheckResult {
+    /** Whether synthesis is due. */
+    due: boolean;
+    /** Human-readable reason for the decision. */
+    reason: string;
+    /** Per-section breakdown of what needs updating. */
+    sectionsToUpdate: Record<ProfileSectionKey, boolean>;
+    /** Number of unprocessed signals since last synthesis. */
+    pendingSignalCount: number;
+    /** ISO 8601 timestamp of the last synthesis (null if never run). */
+    lastSynthesisAt: string | null;
+}
+/** A snapshot of the profile at a point in time. */
+export interface ProfileSnapshot {
+    /** Snapshot ID. */
+    id: string;
+    /** ISO 8601 timestamp when the snapshot was taken. */
+    timestamp: string;
+    /** The profile state at this point. */
+    profile: OperatorProfile;
+    /** What triggered this snapshot (e.g., "synthesis", "manual"). */
+    trigger: string;
+    /** Summary of changes from the previous snapshot. */
+    changeSummary: string;
+}
+/** History of an operator profile — tracks evolution over time. */
+export interface OperatorProfileHistory {
+    /** Profile ID this history belongs to. */
+    profileId: string;
+    /** Ordered list of snapshots (newest first). */
+    snapshots: ProfileSnapshot[];
+    /** Total number of synthesis passes performed. */
+    synthesisCount: number;
+    /** Total number of signals processed across all time. */
+    totalSignalsProcessed: number;
+}
+export {};
+//# sourceMappingURL=operator-types.d.ts.map

package/dist/operator/operator-types.d.ts.map

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

package/dist/operator/operator-types.js

@@ -0,0 +1,24 @@
+/**
+ * Operator Profile Types — type foundation for the Operator Profile module.
+ *
+ * Defines signals, profile sections, synthesis checks, and history
+ * for personality learning and adaptation.
+ */
+// =============================================================================
+// SIGNAL TYPES
+// =============================================================================
+/** All recognized signal types emitted during operator interaction. */
+export var SignalType;
+(function (SignalType) {
+    SignalType["CommandStyle"] = "command_style";
+    SignalType["WorkRhythm"] = "work_rhythm";
+    SignalType["ToolPreference"] = "tool_preference";
+    SignalType["SessionDepth"] = "session_depth";
+    SignalType["DomainExpertise"] = "domain_expertise";
+    SignalType["Correction"] = "correction";
+    SignalType["Frustration"] = "frustration";
+    SignalType["PersonalShare"] = "personal_share";
+    SignalType["CommunicationPref"] = "communication_pref";
+    SignalType["ReactionToOutput"] = "reaction_to_output";
+})(SignalType || (SignalType = {}));
+//# sourceMappingURL=operator-types.js.map

package/dist/operator/operator-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-types.js","sourceRoot":"","sources":["../../src/operator/operator-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF,uEAAuE;AACvE,MAAM,CAAN,IAAY,UAWX;AAXD,WAAY,UAAU;IACpB,4CAA8B,CAAA;IAC9B,wCAA0B,CAAA;IAC1B,gDAAkC,CAAA;IAClC,4CAA8B,CAAA;IAC9B,kDAAoC,CAAA;IACpC,uCAAyB,CAAA;IACzB,yCAA2B,CAAA;IAC3B,8CAAgC,CAAA;IAChC,sDAAwC,CAAA;IACxC,qDAAuC,CAAA;AACzC,CAAC,EAXW,UAAU,KAAV,UAAU,QAWrB"}

package/dist/packs/types.d.ts

@@ -39,17 +39,17 @@ export declare const packManifestSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         id: string;
         description: string;
-        provides: string[];
-        requires: string[];
-        depends: string[];
         knowledge: string[];
+        depends: string[];
+        requires: string[];
+        provides: string[];
     }, {
         id: string;
         description: string;
-        provides: string[];
         requires: string[];
-        depends?: string[] | undefined;
+        provides: string[];
         knowledge?: string[] | undefined;
+        depends?: string[] | undefined;
     }>, "many">>>;
     /** Facade definitions (same as plugin manifest) */
     facades: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -60,8 +60,8 @@ export declare const packManifestSchema: z.ZodObject<{
             description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
             auth: z.ZodDefault<z.ZodOptional<z.ZodEnum<["read", "write", "admin"]>>>;
         }, "strip", z.ZodTypeAny, {
-            name: string;
             description: string;
+            name: string;
             auth: "read" | "write" | "admin";
         }, {
             name: string;
@@ -69,11 +69,11 @@ export declare const packManifestSchema: z.ZodObject<{
             auth?: "read" | "write" | "admin" | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
-        name: string;
         description: string;
+        name: string;
         ops: {
-            name: string;
             description: string;
+            name: string;
             auth: "read" | "write" | "admin";
         }[];
     }, {
@@ -113,33 +113,33 @@ export declare const packManifestSchema: z.ZodObject<{
         dir?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    id: string;
-    name: string;
+    domains: string[];
     version: string;
+    id: string;
     description: string;
-    domains: string[];
-    dependencies: string[];
+    name: string;
     capabilities: {
         id: string;
         description: string;
-        provides: string[];
-        requires: string[];
-        depends: string[];
         knowledge: string[];
+        depends: string[];
+        requires: string[];
+        provides: string[];
     }[];
+    dependencies: string[];
     facades: {
-        name: string;
         description: string;
+        name: string;
         ops: {
-            name: string;
             description: string;
+            name: string;
             auth: "read" | "write" | "admin";
         }[];
     }[];
-    engine?: string | undefined;
     vault?: {
         dir: string;
     } | undefined;
+    engine?: string | undefined;
     skills?: {
         dir: string;
     } | undefined;
@@ -147,21 +147,23 @@ export declare const packManifestSchema: z.ZodObject<{
         dir: string;
     } | undefined;
 }, {
+    version: string;
     id: string;
     name: string;
-    version: string;
-    description?: string | undefined;
     domains?: string[] | undefined;
-    engine?: string | undefined;
-    dependencies?: string[] | undefined;
+    description?: string | undefined;
+    vault?: {
+        dir?: string | undefined;
+    } | undefined;
     capabilities?: {
         id: string;
         description: string;
-        provides: string[];
         requires: string[];
-        depends?: string[] | undefined;
+        provides: string[];
         knowledge?: string[] | undefined;
+        depends?: string[] | undefined;
     }[] | undefined;
+    dependencies?: string[] | undefined;
     facades?: {
         name: string;
         ops: {
@@ -171,9 +173,7 @@ export declare const packManifestSchema: z.ZodObject<{
         }[];
         description?: string | undefined;
     }[] | undefined;
-    vault?: {
-        dir?: string | undefined;
-    } | undefined;
+    engine?: string | undefined;
     skills?: {
         dir?: string | undefined;
     } | undefined;

package/dist/paths.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Soleri path constants — single source of truth for all data locations.
+ *
+ * Default layout:
+ *   ~/.soleri/              ← SOLERI_HOME (shared vault, global config)
+ *   ~/.soleri/{agentId}/    ← agent home (vault, plans, keys, flags, templates)
+ *
+ * Legacy fallback:
+ *   If ~/.soleri/{agentId}/vault.db doesn't exist but ~/.{agentId}/vault.db does,
+ *   the old path is used and a migration warning is emitted once per process.
+ *   Run `soleri agent migrate <agentId>` to move data to the new location.
+ *
+ * Override with SOLERI_HOME env var or explicit paths in agent.yaml → engine.vault.
+ */
+/** Root directory for all Soleri data. Default: ~/.soleri/ */
+export declare const SOLERI_HOME: string;
+/** Returns true if the given agent is using legacy paths via fallback. */
+export declare function usedLegacyFallback(agentId: string): boolean;
+/**
+ * Legacy agent home: ~/.{agentId}/ (pre-v8 layout).
+ * Exported for use by the migration command.
+ */
+export declare function legacyAgentHome(agentId: string): string;
+/** Agent-specific data directory: ~/.soleri/{agentId}/ */
+export declare function agentHome(agentId: string): string;
+/** Agent vault database path (with legacy fallback). */
+export declare function agentVaultPath(agentId: string): string;
+/** Agent plans store (with legacy fallback). */
+export declare function agentPlansPath(agentId: string): string;
+/** Agent keys file (with legacy fallback). */
+export declare function agentKeysPath(agentId: string): string;
+/** Agent templates directory (with legacy fallback). */
+export declare function agentTemplatesDir(agentId: string): string;
+/** Agent feature flags (with legacy fallback). */
+export declare function agentFlagsPath(agentId: string): string;
+/** Agent knowledge directory for browsable markdown sync. */
+export declare function agentKnowledgeDir(agentId: string): string;
+/** Shared vault path: ~/.soleri/vault.db (cross-agent intelligence) */
+export declare function sharedVaultPath(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,8DAA8D;AAC9D,eAAO,MAAM,WAAW,QAAwD,CAAC;AAUjF,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAyBD,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAItD;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAItD;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,wDAAwD;AACxD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED,kDAAkD;AAClD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAItD;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,uEAAuE;AACvE,wBAAgB,eAAe,IAAI,MAAM,CAExC"}