attention-manifest-protocol 0.4.2 → 0.4.4

package/src/process/agent.ts

@@ -1,341 +0,0 @@
-/**
- * Agent facets: because a process is a person, identity belongs here.
- *
- * This is not a second lifecycle. `process.ts` owns the runtime state
- * (created/running/idle/suspended/terminated); this module owns the biography:
- * self narrative, roles, memories, affect, background processes and life
- * events. Storage adapters implement `AgentStore`.
- */
-import type { Confidence, Id, Pid, Ref, Timestamp } from "../types/common.ts";
-
-export type { Pid } from "../types/common.ts";
-
-export type MemoryKind = "episodic" | "semantic" | "procedural" | "social" | "affective";
-export type RoleStatus = "active" | "retired";
-export type BackgroundKind = "habit" | "emotion" | "monitor" | "drive";
-export type BackgroundStatus = "active" | "paused" | "retired";
-export type LifeEventKind = "turning-point" | "role-transition" | "relationship" | "achievement" | "loss" | "insight" | "other";
-
-export type AgentErrorCode =
-    | "agent_not_found"
-    | "profile_exists"
-    | "role_not_found"
-    | "role_not_assigned"
-    | "memory_not_found"
-    | "invalid_memory"
-    | "invalid_affect"
-    | "relationship_not_found"
-    | "institution_not_found";
-
-/**
- * Summary of the current person; the narrative version is stored separately.
- */
-export interface AgentProfile {
-    pid: Pid;
-    name: string;
-    lifeChapter: string;
-    values: string[];
-    constraints: string[];
-    version: number;
-    updatedAt: Timestamp;
-}
-
-/**
- * Append-only self narrative. `version` starts at 1 and only increases.
- */
-export interface SelfNarrative {
-    pid: Pid;
-    version: number;
-    identity: Record<string, unknown>;
-    narrative: string;
-    at: Timestamp;
-    /**
-     * Object-store sequence when the narrative is hash-chained.
-     */
-    objectSeq?: number;
-}
-
-export interface Obligation {
-    id: Id;
-    statement: string;
-    audience?: string;
-    /**
-     * Obligation ids in other roles that cannot be satisfied together with this one.
-     */
-    conflictsWith?: Id[];
-    weight?: Confidence;
-}
-
-export interface Role {
-    id: Id;
-    label: string;
-    obligations: Obligation[];
-    expectations: string[];
-    audiences: string[];
-    scripts: string[];
-    status: RoleStatus;
-    createdAt: Timestamp;
-}
-
-export interface RoleAssignment {
-    role: Role;
-    salience: number;
-    active: boolean;
-    since: Timestamp;
-}
-
-export interface Memory {
-    id: Id;
-    pid: Pid;
-    roleId?: Id;
-    kind: MemoryKind;
-    content: string;
-    /**
-     * Retrieval salience in [0, 1]; mutable metadata, not truth.
-     */
-    salience: number;
-    at: Timestamp;
-    /**
-     * Pointers into warrant/objects; a memory is not itself evidence.
-     */
-    refs: Ref[];
-    source?: string;
-    consolidated: boolean;
-}
-
-export interface AffectState {
-    pid: Pid;
-    /**
-     * [-1, 1]
-     */
-    valence: number;
-    /**
-     * [0, 1]
-     */
-    arousal: number;
-    /**
-     * [0, 1]
-     */
-    stress: number;
-    /**
-     * [0, 1]
-     */
-    fatigue: number;
-    mood: string;
-    updatedAt: Timestamp;
-}
-
-export interface BackgroundProcess {
-    id: Id;
-    pid: Pid;
-    kind: BackgroundKind;
-    label: string;
-    /**
-     * [0, 1]
-     */
-    intensity: number;
-    trigger?: string;
-    script?: string;
-    status: BackgroundStatus;
-    updatedAt: Timestamp;
-}
-
-export interface LifeEvent {
-    id: Id;
-    pid: Pid;
-    kind: LifeEventKind;
-    summary: string;
-    at: Timestamp;
-    roleId?: Id;
-    /**
-     * [0, 1]
-     */
-    impact: number;
-    narrativeVersion?: number;
-}
-
-export interface NewAgentProfile {
-    pid: Pid;
-    name: string;
-    lifeChapter?: string;
-    values?: string[];
-    constraints?: string[];
-    at: Timestamp;
-}
-
-export interface NewNarrative {
-    pid: Pid;
-    identity: Record<string, unknown>;
-    narrative: string;
-    at: Timestamp;
-}
-
-export interface NewRole {
-    id: Id;
-    label: string;
-    obligations?: Obligation[];
-    expectations?: string[];
-    audiences?: string[];
-    scripts?: string[];
-    createdAt: Timestamp;
-}
-
-export interface AssignRoleInput {
-    pid: Pid;
-    roleId: Id;
-    salience?: number;
-    active?: boolean;
-    since: Timestamp;
-}
-
-export interface ActivateRoleInput {
-    pid: Pid;
-    roleId: Id;
-    at: Timestamp;
-}
-
-export interface NewMemory {
-    pid: Pid;
-    roleId?: Id;
-    kind: MemoryKind;
-    content: string;
-    salience?: number;
-    at: Timestamp;
-    refs?: Ref[];
-    source?: string;
-}
-
-export interface MemoryQuery {
-    kind?: MemoryKind;
-    roleId?: Id;
-    minSalience?: number;
-    before?: Timestamp;
-    limit?: number;
-    includeConsolidated?: boolean;
-}
-
-export interface AffectInput {
-    valence?: number;
-    arousal?: number;
-    stress?: number;
-    fatigue?: number;
-    mood?: string;
-}
-
-export interface NewBackgroundProcess {
-    pid: Pid;
-    kind: BackgroundKind;
-    label: string;
-    intensity?: number;
-    trigger?: string;
-    script?: string;
-    at: Timestamp;
-}
-
-export interface NewLifeEvent {
-    pid: Pid;
-    kind: LifeEventKind;
-    summary: string;
-    at: Timestamp;
-    roleId?: Id;
-    impact?: number;
-    narrativeVersion?: number;
-}
-
-export interface AgentReader {
-    profile(pid: Pid): AgentProfile | undefined;
-    narrative(pid: Pid, version?: number): SelfNarrative | undefined;
-    roles(pid: Pid): RoleAssignment[];
-    activeRole(pid: Pid): RoleAssignment | undefined;
-    memories(pid: Pid, query?: MemoryQuery): Memory[];
-    affect(pid: Pid): AffectState | undefined;
-    background(pid: Pid, status?: BackgroundStatus): BackgroundProcess[];
-    lifeEvents(pid: Pid, limit?: number): LifeEvent[];
-}
-
-export interface AgentStore extends AgentReader {
-    createProfile(input: NewAgentProfile): AgentProfile;
-    reviseNarrative(input: NewNarrative): SelfNarrative;
-    addRole(input: NewRole): Role;
-    assignRole(input: AssignRoleInput): RoleAssignment;
-    activateRole(input: ActivateRoleInput): RoleAssignment;
-    remember(input: NewMemory): Memory;
-    forget(pid: Pid, memoryId: Id): boolean;
-    consolidate(pid: Pid, memoryIds: Id[], at: Timestamp): number;
-    setAffect(pid: Pid, input: AffectInput, at: Timestamp): AffectState;
-    addBackground(input: NewBackgroundProcess): BackgroundProcess;
-    setBackgroundStatus(pid: Pid, id: Id, status: BackgroundStatus, at: Timestamp): BackgroundProcess;
-    recordLifeEvent(input: NewLifeEvent): LifeEvent;
-}
-
-export type AgentEvent =
-    | {
-          type: "agent.created";
-          pid: Pid;
-          at: Timestamp;
-      }
-    | {
-          type: "agent.narrative.revised";
-          pid: Pid;
-          version: number;
-          at: Timestamp;
-      }
-    | {
-          type: "agent.role.added";
-          pid: Pid;
-          roleId: Id;
-          at: Timestamp;
-      }
-    | {
-          type: "agent.role.assigned";
-          pid: Pid;
-          roleId: Id;
-          at: Timestamp;
-      }
-    | {
-          type: "agent.role.activated";
-          pid: Pid;
-          roleId: Id;
-          at: Timestamp;
-      }
-    | {
-          type: "agent.role.retired";
-          pid: Pid;
-          roleId: Id;
-          at: Timestamp;
-      }
-    | {
-          type: "agent.memory.recorded";
-          pid: Pid;
-          memoryId: Id;
-          at: Timestamp;
-      }
-    | {
-          type: "agent.memory.consolidated";
-          pid: Pid;
-          memoryIds: Id[];
-          at: Timestamp;
-      }
-    | {
-          type: "agent.memory.forgotten";
-          pid: Pid;
-          memoryId: Id;
-          at: Timestamp;
-      }
-    | {
-          type: "agent.affect.changed";
-          pid: Pid;
-          at: Timestamp;
-      }
-    | {
-          type: "agent.background.changed";
-          pid: Pid;
-          backgroundId: Id;
-          at: Timestamp;
-      }
-    | {
-          type: "agent.life_event.recorded";
-          pid: Pid;
-          lifeEventId: Id;
-          at: Timestamp;
-      };

package/src/process/agentService.ts

@@ -1,236 +0,0 @@
-/**
- * Agent service: the use-cases of a person, expressed only through ports.
- *
- * `createAgent` is the only place that touches the execution boundary: it asks
- * the execution port for a pid, then creates the profile, default role, first
- * self narrative and neutral affect state.
- */
-import type { Budget, Id, Timestamp } from "../types/common.ts";
-import type {
-    ActivateRoleInput,
-    AffectInput,
-    AffectState,
-    AgentProfile,
-    AgentReader,
-    AgentStore,
-    AssignRoleInput,
-    BackgroundProcess,
-    BackgroundStatus,
-    LifeEvent,
-    Memory,
-    MemoryQuery,
-    NewBackgroundProcess,
-    NewLifeEvent,
-    NewMemory,
-    NewNarrative,
-    NewRole,
-    Obligation,
-    Pid,
-    Role,
-    RoleAssignment,
-    SelfNarrative,
-} from "./agent.ts";
-import type { Institution, JoinInstitutionInput, Membership, NewInstitution, NewRelationship, Relationship, SocialReader, SocialStore } from "../ipc/social.ts";
-import type { AgentContext, AgentContextAssembler, AgentContextOptions } from "../context/agentContext.ts";
-import { assembleAgentContext } from "../context/agentContext.ts";
-
-export interface CreateProcessInput {
-    id: Id;
-    name: string;
-    at: Timestamp;
-}
-
-export interface CreateProcessResult {
-    pid: Pid;
-}
-
-export interface AgentExecutionPort {
-    createProcess(input: CreateProcessInput): CreateProcessResult;
-}
-
-export interface CreateAgentInput {
-    /**
-     * Process id used by the execution layer; required when no port is wired.
-     */
-    id: Id;
-    /**
-     * Supply only when the caller already created the process.
-     */
-    pid?: Pid;
-    name: string;
-    lifeChapter?: string;
-    values?: string[];
-    constraints?: string[];
-    narrative?: string;
-    identity?: Record<string, unknown>;
-    at: Timestamp;
-}
-
-export interface CreateAgentResult {
-    pid: Pid;
-    profile: AgentProfile;
-    narrative: SelfNarrative;
-    role: RoleAssignment;
-}
-
-/**
- * One pair of obligations, drawn from two assigned roles, that cannot be
- * satisfied together.
- */
-export interface RoleConflict {
-    left: Role;
-    right: Role;
-    obligation: string;
-    other: string;
-}
-
-export class AgentService implements AgentContextAssembler {
-    readonly agents: AgentStore;
-    readonly social: SocialStore;
-    private readonly execution?: AgentExecutionPort;
-
-    constructor(agents: AgentStore, social: SocialStore, execution?: AgentExecutionPort) {
-        this.agents = agents;
-        this.social = social;
-        this.execution = execution;
-    }
-
-    createAgent(input: CreateAgentInput): CreateAgentResult {
-        const pid: Pid = input.pid ?? this.execution?.createProcess({ id: input.id, name: input.name, at: input.at }).pid ?? Number.NaN;
-        if (!Number.isSafeInteger(pid) || pid <= 0) {
-            throw new Error("AgentService.createAgent needs a pid or an AgentExecutionPort");
-        }
-        const profile: AgentProfile = this.agents.createProfile({
-            pid,
-            name: input.name,
-            lifeChapter: input.lifeChapter,
-            values: input.values,
-            constraints: input.constraints,
-            at: input.at,
-        });
-        const role: Role = this.agents.addRole({
-            id: `role.self.${pid}`,
-            label: "self",
-            obligations: [],
-            expectations: [],
-            audiences: [],
-            scripts: [],
-            createdAt: input.at,
-        });
-        const assignment: RoleAssignment = this.agents.assignRole({ pid, roleId: role.id, salience: 1, active: true, since: input.at });
-        const narrative: SelfNarrative = this.agents.reviseNarrative({
-            pid,
-            identity: input.identity ?? { name: input.name },
-            narrative: input.narrative ?? `I am ${input.name}. I am at the beginning of a life chapter.`,
-            at: input.at,
-        });
-        this.agents.setAffect(pid, { valence: 0, arousal: 0, stress: 0, fatigue: 0, mood: "neutral" }, input.at);
-        return { pid, profile, narrative, role: assignment };
-    }
-
-    reviseNarrative(pid: Pid, narrative: string, identity: Record<string, unknown>, at: Timestamp): SelfNarrative {
-        const input: NewNarrative = { pid, identity, narrative, at };
-        return this.agents.reviseNarrative(input);
-    }
-
-    addRole(input: NewRole): Role {
-        return this.agents.addRole(input);
-    }
-
-    assignRole(input: AssignRoleInput): RoleAssignment {
-        return this.agents.assignRole(input);
-    }
-
-    activateRole(input: ActivateRoleInput): RoleAssignment {
-        return this.agents.activateRole(input);
-    }
-
-    remember(input: NewMemory): Memory {
-        return this.agents.remember(input);
-    }
-
-    recall(pid: Pid, query: MemoryQuery = {}): Memory[] {
-        return this.agents.memories(pid, query);
-    }
-
-    setAffect(pid: Pid, input: AffectInput, at: Timestamp): AffectState {
-        return this.agents.setAffect(pid, input, at);
-    }
-
-    addBackground(input: NewBackgroundProcess): BackgroundProcess {
-        return this.agents.addBackground(input);
-    }
-
-    setBackgroundStatus(pid: Pid, id: Id, status: BackgroundStatus, at: Timestamp): BackgroundProcess {
-        return this.agents.setBackgroundStatus(pid, id, status, at);
-    }
-
-    recordLifeEvent(input: NewLifeEvent): LifeEvent {
-        return this.agents.recordLifeEvent(input);
-    }
-
-    relate(input: NewRelationship): Relationship {
-        return this.social.upsertRelationship(input);
-    }
-
-    createInstitution(input: NewInstitution): Institution {
-        return this.social.createInstitution(input);
-    }
-
-    joinInstitution(input: JoinInstitutionInput): Membership {
-        return this.social.joinInstitution(input);
-    }
-
-    leaveInstitution(pid: Pid, institutionId: Id, at: Timestamp): Membership {
-        return this.social.leaveInstitution(pid, institutionId, at);
-    }
-
-    relationships(pid: Pid): Relationship[] {
-        return this.social.relationships(pid);
-    }
-
-    memberships(pid: Pid): Membership[] {
-        return this.social.memberships(pid);
-    }
-
-    /**
-     * Roles are social positions, so conflict is an obligation-level fact, not
-     * a permission error. This is intentionally a read-only diagnostic.
-     */
-    roleConflicts(pid: Pid): RoleConflict[] {
-        const assignments: RoleAssignment[] = this.agents.roles(pid);
-        const conflicts: RoleConflict[] = [];
-        for (let leftIndex: number = 0; leftIndex < assignments.length; leftIndex += 1) {
-            for (let rightIndex: number = leftIndex + 1; rightIndex < assignments.length; rightIndex += 1) {
-                const left: Role = assignments[leftIndex].role;
-                const right: Role = assignments[rightIndex].role;
-                for (let obligationIndex: number = 0; obligationIndex < left.obligations.length; obligationIndex += 1) {
-                    const obligation: Obligation = left.obligations[obligationIndex];
-                    for (let otherIndex: number = 0; otherIndex < right.obligations.length; otherIndex += 1) {
-                        const other: Obligation = right.obligations[otherIndex];
-                        if (obligation.conflictsWith?.includes(other.id) === true || other.conflictsWith?.includes(obligation.id) === true) {
-                            conflicts.push({ left, right, obligation: obligation.id, other: other.id });
-                        }
-                    }
-                }
-            }
-        }
-        return conflicts;
-    }
-
-    assemble(pid: Pid, budget: Budget, options?: AgentContextOptions): AgentContext {
-        return assembleAgentContext(this.agents, this.social, pid, budget, options);
-    }
-
-    context(pid: Pid, budget: Budget, options?: AgentContextOptions): AgentContext {
-        return this.assemble(pid, budget, options);
-    }
-
-    reader(): AgentReader {
-        return this.agents;
-    }
-
-    socialReader(): SocialReader {
-        return this.social;
-    }
-}