@iniesta8888/agent-live-dsh-adapter 0.3.0

package/lib/types/dsh/src/index.d.ts

@@ -0,0 +1,4 @@
+import type { Context } from "@deepseek-ai/cordis";
+export declare const inject: string[];
+/** Register the native view's bounded Creator capabilities in the DSH Host. */
+export declare function apply(ctx: Context): Promise<void>;

package/lib/types/src/content/compiler.d.ts

@@ -0,0 +1,30 @@
+import { type OfficeSpec } from "./schema.ts";
+import { type ComponentLibraryView, type ValidationIssue } from "./validator.ts";
+export interface CompileAdjustment {
+    code: string;
+    path: string;
+    message: string;
+}
+export interface CompileResult {
+    draft?: OfficeSpec;
+    errors: ValidationIssue[];
+    adjustments: CompileAdjustment[];
+}
+/** The common compilation gate used by both Official and Custom Office Specs. */
+export declare function compileOfficeSpec(input: unknown, library: ComponentLibraryView): CompileResult;
+/**
+ * Creates the smallest valid custom office around a registered room.
+ * Internal primitive: Creator never starts from an empty room, it edits the
+ * Preset Office that already owns the room (see CreatorService.customize).
+ */
+export declare function compileOfficeSeed(input: unknown, library: ComponentLibraryView): CompileResult;
+/**
+ * The id a patch targets when it does not name one: a Custom Office keeps its
+ * identity, a Preset Office is copied into its single editable local Office.
+ */
+export declare function patchOfficeId(base: OfficeSpec): string;
+/** The Preset a `local/<preset>` Office id is reserved for. */
+export declare function presetIdForLocalId(localId: string): string | undefined;
+/** The Preset an Office descends from; an official Office is its own Preset. */
+export declare function ownerPresetId(base: OfficeSpec): string | undefined;
+export declare function compileOfficePatch(base: OfficeSpec, patchInput: unknown, library: ComponentLibraryView): CompileResult;

package/lib/types/src/content/graph-validator.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Structural rules for a renderable content graph — the single source of truth.
+ *
+ * Two consumers share this module:
+ *  - the browser imports the generated `web/v2/graph-validator.js`
+ *    (see `tsconfig.web-validator.json` and `scripts/web-validator.mjs`);
+ *  - the local server imports the TypeScript module directly, so the same rules
+ *    gate saving an Office Spec and serving `/api/office-content`.
+ *
+ * Keep this file dependency-free, platform-neutral, and side-effect-free: it is
+ * compiled for the browser and bundled into every host integration.
+ */
+/** Capabilities every layout must expose as a walkable work station. */
+export declare const WORK_CAPABILITIES: readonly ["research", "create", "compute", "plan", "communicate", "collaborate"];
+/** Renderer-resolved destinations that deliberately do not belong to a layout. */
+export declare const DYNAMIC_ACTIVITY_TARGETS: Set<string>;
+export interface ContentIssue {
+    code: string;
+    path: string;
+    message: string;
+}
+/**
+ * What an activity needs to be staged: a named prop instance, or a capability
+ * any matching prop type can provide. The named form is the legacy syntax;
+ * capability requirements let the same implementation be reused across layouts
+ * and stop a prop swap from satisfying an activity by id alone.
+ */
+export type ActivityRequirement = string | {
+    prop: string;
+} | {
+    capability: string;
+};
+export interface ResolvedRequirements {
+    /** Resolved instance id per requirement, aligned by index; null when unresolved. */
+    bindings: (string | null)[];
+    issues: ContentIssue[];
+}
+/**
+ * Resolves activity requirements against the props actually present, so both
+ * syntaxes stay valid while content migrates.
+ */
+export declare function resolveActivityRequirements(requires: readonly unknown[] | undefined, instances: Iterable<readonly [string, string]>, capabilitiesOf: (type: string) => readonly string[], activity: string): ResolvedRequirements;
+export declare function assertManifest(value: unknown, kind: string): void;
+/**
+ * Layout structure rules. `propTypeNames` are the type names a layout may
+ * reference; the library stores props namespaced while the rendered graph does
+ * not, so both callers normalize before calling.
+ */
+export declare function layoutIssues(layout: any, propTypeNames: Iterable<string>): ContentIssue[];
+/** Every reason the browser would refuse to render this resolved content graph. */
+export declare function graphIssues(content: any): ContentIssue[];
+/** Browser entry point: refuse the first structural problem, exactly as rendered. */
+export declare function validateRegistry(content: unknown): void;
+/** Server entry point: report every problem at once for the Creator surface. */
+export declare function graphIssueMessages(content: unknown): string[];

package/lib/types/src/content/library.d.ts

@@ -0,0 +1,3 @@
+import type { ComponentLibraryView } from "./validator.ts";
+export declare function loadComponentLibrary(contentRoot: string): Promise<ComponentLibraryView>;
+export declare function loadOfficialOffices(contentRoot: string): Promise<any[]>;

package/lib/types/src/content/registry.d.ts

@@ -0,0 +1,33 @@
+import { EventEmitter } from "node:events";
+import type { OfficeSpec } from "./schema.ts";
+import { type ComponentLibraryView, type ValidationIssue } from "./validator.ts";
+export interface RegistryEntry {
+    id: string;
+    name: string;
+    origin: "official" | "custom";
+    selected: boolean;
+}
+export interface SaveResult {
+    saved: boolean;
+    issues: ValidationIssue[];
+}
+export interface OfficeRegistryOptions {
+    root: string;
+    library: ComponentLibraryView;
+    officialOffices: OfficeSpec[];
+    fallbackOffice?: string;
+}
+export declare class OfficeRegistry {
+    #private;
+    readonly root: string;
+    constructor(options: OfficeRegistryOptions);
+    onChange(listener: (id: string | undefined) => void): () => EventEmitter<[never]>;
+    initialize(): Promise<void>;
+    list(): Promise<RegistryEntry[]>;
+    get(id: string): Promise<OfficeSpec | undefined>;
+    save(spec: OfficeSpec): Promise<SaveResult>;
+    remove(id: string): Promise<boolean>;
+    select(id: string): Promise<void>;
+    selectedId(): Promise<string>;
+    selected(): Promise<OfficeSpec>;
+}

package/lib/types/src/content/runtime-content.d.ts

@@ -0,0 +1,62 @@
+import type { OfficeSpec } from "./schema.ts";
+import type { ComponentLibraryView } from "./validator.ts";
+/** Compiles a validated Office Spec into the renderer's current in-memory content graph. */
+export declare function resolveRuntimeContent(spec: OfficeSpec, contentRoot: string, library: ComponentLibraryView): Promise<{
+    preset: Record<string, unknown>;
+    style: any;
+    layout: any;
+    agentSkin: any;
+    agentProfile: {
+        appearance: any;
+        title?: string | undefined;
+        name?: string | undefined;
+        template: any;
+    };
+    props: {
+        schemaVersion: number;
+        kind: string;
+        id: string;
+        name: string;
+        version: string;
+        contract: string;
+        types: {
+            [k: string]: {
+                size: any;
+                capabilities: any;
+                renderer: any;
+            };
+        };
+    };
+    npcs: {
+        schemaVersion: number;
+        kind: string;
+        id: string;
+        name: string;
+        version: string;
+        contract: string;
+        entries: {
+            role: any;
+            id: string;
+            template?: string;
+            profile?: string;
+            name?: string;
+            title?: string;
+            gender?: import("./schema.ts").Gender;
+            appearance?: import("./schema.ts").Appearance;
+            spawn?: string;
+            shift?: import("./schema.ts").Shift;
+            pose?: import("./schema.ts").NpcPose;
+        }[];
+    };
+    lifeActivities: {
+        schemaVersion: number;
+        kind: string;
+        id: string;
+        name: string;
+        version: string;
+        contract: string;
+        entries: any[];
+    };
+    atmosphere: any;
+    environment: any;
+}>;

package/lib/types/src/content/schema.d.ts

@@ -0,0 +1,141 @@
+export declare const OFFICE_SPEC_SCHEMA_VERSION: 1;
+export declare const GENDER_VALUES: readonly ["female", "male", "nonbinary", "unspecified"];
+export declare const POSE_VALUES: readonly ["stand", "sit"];
+export declare const ORIENTATION_VALUES: readonly ["horizontal", "vertical"];
+export declare const WEATHER_VALUES: readonly ["clear", "cloudy", "rain", "snow"];
+export declare const OFFICE_SPEC_DEFAULTS: Readonly<{
+    style: "builtin/pixel-classic";
+    agentSkin: "builtin/tiny-developers";
+    atmosphere: "builtin/default-atmosphere";
+    environment: "builtin/local-office-environment";
+    agentProfile: Readonly<{
+        template: "builtin/host-agent";
+    }>;
+    placements: readonly never[];
+    npcs: readonly never[];
+    activities: readonly never[];
+}>;
+export type Gender = (typeof GENDER_VALUES)[number];
+export type NpcPose = (typeof POSE_VALUES)[number];
+export type PropOrientation = (typeof ORIENTATION_VALUES)[number];
+export type Weather = (typeof WEATHER_VALUES)[number];
+export interface Shift {
+    start: string;
+    end: string;
+    /** Optional latest departure; each NPC gets a stable daily time in the range. */
+    endLatest?: string;
+}
+export interface Appearance {
+    skin?: string;
+    hair?: string;
+    shirt?: string;
+    trim?: string;
+    badge?: string;
+}
+export interface OfficePlacement {
+    id: string;
+    component: string;
+    slot: string;
+    orientation?: PropOrientation;
+}
+export interface OfficeNpc {
+    id: string;
+    template?: string;
+    profile?: string;
+    name?: string;
+    title?: string;
+    gender?: Gender;
+    appearance?: Appearance;
+    spawn?: string;
+    shift?: Shift;
+    pose?: NpcPose;
+}
+export interface AgentProfile {
+    template: string;
+    name?: string;
+    title?: string;
+    appearance?: Appearance;
+}
+export interface EnvironmentOverrides {
+    clock?: {
+        mode: "local" | "fixed";
+        fixedTime?: string;
+    };
+    weather?: {
+        fallback: Weather;
+    };
+    lighting?: {
+        auto: boolean;
+    };
+    npcSchedule?: {
+        defaultShift?: Shift;
+        roleOverrides?: Record<string, Shift>;
+    };
+}
+export interface OfficeSpec {
+    schemaVersion: typeof OFFICE_SPEC_SCHEMA_VERSION;
+    kind: "office-spec";
+    id: string;
+    name: string;
+    origin: "official" | "custom";
+    basePreset?: string;
+    layout: string;
+    style: string;
+    agentSkin: string;
+    placements: OfficePlacement[];
+    npcs: OfficeNpc[];
+    activities: string[];
+    atmosphere: string;
+    environment: string;
+    agentProfile?: AgentProfile;
+    environmentOverrides?: EnvironmentOverrides;
+    /** Plain text for named, fixed display areas; empty text hides an area. */
+    texts?: Record<string, string>;
+}
+export interface OfficePatch {
+    schemaVersion: typeof OFFICE_SPEC_SCHEMA_VERSION;
+    kind: "office-patch";
+    id?: string;
+    base: string;
+    name?: string;
+    components?: {
+        style?: string;
+        agentSkin?: string;
+        atmosphere?: string;
+        environment?: string;
+    };
+    placements?: {
+        upsert?: OfficePlacement[];
+        remove?: string[];
+    };
+    npcs?: {
+        upsert?: OfficeNpc[];
+        remove?: string[];
+    };
+    activities?: {
+        enable?: string[];
+        disable?: string[];
+    };
+    environmentOverrides?: EnvironmentOverrides | null;
+    agentProfile?: AgentProfile | null;
+    texts?: Record<string, string> | null;
+}
+export interface OfficeSeed {
+    schemaVersion: typeof OFFICE_SPEC_SCHEMA_VERSION;
+    kind: "office-seed";
+    id: string;
+    name: string;
+    layout: string;
+    style?: string;
+    agentSkin?: string;
+    atmosphere?: string;
+    environment?: string;
+    agentProfile?: AgentProfile;
+}
+export interface SchemaIssue {
+    path: string;
+    message: string;
+}
+export declare function validateOfficeSpecShape(input: unknown): SchemaIssue[];
+export declare function validateOfficePatchShape(input: unknown): SchemaIssue[];
+export declare function validateOfficeSeedShape(input: unknown): SchemaIssue[];

package/lib/types/src/content/validator.d.ts

@@ -0,0 +1,34 @@
+import { type SchemaIssue } from "./schema.ts";
+export interface ComponentLibraryView {
+    descriptors: {
+        styles: any[];
+        layouts: any[];
+        agentSkins: any[];
+        atmospheres: any[];
+        environments: any[];
+    };
+    styles: Set<string>;
+    layouts: Map<string, any>;
+    agentSkins: Set<string>;
+    props: Map<string, any>;
+    npcTemplates: Map<string, any>;
+    agentProfileTemplates: Map<string, any>;
+    activityRecipes: Map<string, any>;
+    activityImplementations: Map<string, any>;
+    atmospheres: Set<string>;
+    environments: Set<string>;
+    defaultNpcTemplate: string;
+    npcProfilePolicy: {
+        selection: string;
+        seedFrom: string;
+        persistResolvedProfile: boolean;
+    };
+}
+export interface ValidationIssue extends SchemaIssue {
+    code: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    issues: ValidationIssue[];
+}
+export declare function validateOfficeSpec(spec: unknown, library: ComponentLibraryView): ValidationResult;

package/lib/types/src/core/limits.d.ts

@@ -0,0 +1,14 @@
+/** Hard local-renderer limits. Presets may recommend fewer items. */
+export declare const SCENE_LIMITS: Readonly<{
+    agents: 16;
+    seats: 8;
+    npcs: 12;
+    props: 80;
+    animatedProps: 24;
+    activities: 16;
+    effects: 40;
+    visibleBubbles: 4;
+    queuedBubbles: 8;
+}>;
+export type SceneLimitKey = keyof typeof SCENE_LIMITS;
+export declare function withinSceneLimit(kind: SceneLimitKey, count: number): boolean;

package/lib/types/src/core/mapping.d.ts

@@ -0,0 +1,16 @@
+import type { OfficeAction } from "./protocol.ts";
+export declare function isDelegationTool(toolName: string): boolean;
+export declare function actionForTool(toolName: string): OfficeAction;
+/** Human-readable one-liner shown in the speech bubble and the activity log. */
+export declare function labelForTool(toolName: string, args?: Record<string, any>): string;
+export interface DelegatedTask {
+    agent: string;
+    task: string;
+    /** Index used to build a stable child id for parallel/chained runs. */
+    slot: number;
+}
+/**
+ * Normalises the shapes the subagent tool accepts (single / parallel / chain)
+ * into a flat list of workers to bring into the office.
+ */
+export declare function describeDelegation(args?: Record<string, any>): DelegatedTask[];

package/lib/types/src/core/protocol.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Host-neutral wire protocol between coding-agent adapters and Agent Live renderers.
+ * Kept dependency-free so both sides can share the vocabulary without a build step.
+ */
+export type AgentState = "idle" | "thinking" | "working" | "waiting" | "talking" | "done" | "error";
+/** Where the character physically goes in the office for a given piece of work. */
+export type OfficeAction = "type" | "archive" | "server" | "whiteboard" | "phone" | "delegate" | "coffee";
+export interface AgentView {
+    id: string;
+    name: string;
+    role: string;
+    /** Parent agent id for delegated workers. */
+    parent?: string;
+    state: AgentState;
+    /** Short human label of what it is doing right now. */
+    detail?: string;
+    action?: OfficeAction;
+    task?: string;
+    thought?: string;
+    model?: string;
+    tokens: number;
+    cost: number;
+    toolCalls: number;
+    joinedAt: number;
+    seat?: number;
+}
+export interface LogItem {
+    at: number;
+    agentId: string;
+    kind: "thought" | "say" | "tool" | "delegate" | "join" | "leave" | "system";
+    text: string;
+}
+export interface SessionInfo {
+    cwd: string;
+    model?: string;
+    thinkingLevel?: string;
+    busy: boolean;
+    turns: number;
+    startedAt: number;
+}
+export type OfficeDelta = {
+    type: "session";
+    session: SessionInfo;
+} | {
+    type: "agent_join";
+    agent: AgentView;
+} | {
+    type: "agent_leave";
+    id: string;
+    ok?: boolean;
+} | {
+    type: "agent_state";
+    id: string;
+    state: AgentState;
+    detail?: string;
+} | {
+    type: "task";
+    id: string;
+    task: string;
+} | {
+    type: "thought";
+    id: string;
+    text: string;
+} | {
+    type: "say";
+    id: string;
+    text: string;
+} | {
+    type: "action";
+    id: string;
+    action: OfficeAction;
+    label: string;
+    toolCallId: string;
+} | {
+    type: "action_end";
+    id: string;
+    toolCallId: string;
+    ok: boolean;
+} | {
+    type: "delegate";
+    from: string;
+    to: string;
+    task: string;
+} | {
+    type: "usage";
+    id: string;
+    tokens: number;
+    cost: number;
+} | {
+    type: "log";
+    item: LogItem;
+};
+/** One replayable engine event with its original wall-clock timestamp. */
+export interface RecordedOfficeEvent {
+    at: number;
+    event: OfficeDelta;
+}
+export type OfficeEvent = {
+    type: "snapshot";
+    agents: AgentView[];
+    log: LogItem[];
+    session: SessionInfo;
+    history: RecordedOfficeEvent[];
+} | OfficeDelta;

package/lib/types/src/creator/commands.d.ts

@@ -0,0 +1,18 @@
+import { CreatorService } from "./service.ts";
+type CommandResult = {
+    ok: true;
+    data: unknown;
+    adjustments?: unknown[];
+} | {
+    ok: false;
+    error: string;
+    issues?: unknown[];
+    adjustments?: unknown[];
+};
+/** Closed command surface used by every host integration; it never executes arbitrary code or paths. */
+export declare class CreatorCommandRouter {
+    #private;
+    constructor(creator: CreatorService);
+    execute(value: unknown): Promise<CommandResult>;
+}
+export {};

package/lib/types/src/creator/mode.d.ts

@@ -0,0 +1,9 @@
+export declare const CREATOR_MODE_CONTEXT = "Agent Live Creator Mode is active for this session.\nTreat office-related natural language as a request to modify the currently selected Custom Office and use the agent_live_creator tool.\nThe currently selected Office is the only edit target. Do not inspect files, search for another copy, deliberate about replacement, invent a new Office id, or pass base/id unless the user explicitly selected another listed Office.\nOn the first edit, call list_components with the default compact summary at most once to obtain the current Agent Profile, text areas, and NPC ids. Then call customize immediately. Do not call list_offices or broader component categories unless the request genuinely needs an unknown choice.\nFor common edits, use these internal Patch shapes: agentProfile { template: \"builtin/host-agent\", name?, title? }; texts { company?, notice?, slogan? }; npcs { upsert: [{ id, template?, name?, title?, gender?, spawn?, pose? }], remove?: [id] }. Rename an existing NPC by its summary id. Add an ordinary colleague with a unique id and template \"builtin/colleague\"; omitted profile and appearance are resolved deterministically.\nDo not expose schemas, patches, or component ids unless explicitly asked for implementation details.\nIf a request is unrelated to the office or ambiguous, do not perform it. Explain that Creator Mode is active and offer exactly these choices: continue editing, /agent-live list presets, /agent-live preset <number or name>, /agent-live custom, or /agent-live exit.\nMap a request like \"make me a police station\" onto the closest complete Preset Office, then change its name, people, identities, furniture, style and activities. If the request needs a brand-new room structure (walls, areas, lanes, seats or work stations), say that it requires adding a new Office Preset and therefore a source change; never offer to swap a room in place.\nAn Office keeps its room. Moving to another room means selecting that Preset Office and editing a copy of it.\nAfter every response, state that Creator Mode remains active and mention /agent-live exit.";
+/** Host-neutral, in-memory Creator state keyed by the host's stable session identity. */
+export declare class CreatorModeRegistry {
+    #private;
+    enter(sessionId: string): void;
+    exit(sessionId: string): boolean;
+    isActive(sessionId: string): boolean;
+    clear(): void;
+}