actoviq-agent-sdk 0.4.12 → 0.4.13

package/dist/src/manager/referenceIndex.js

@@ -0,0 +1,167 @@
+import { migrateRouterRouteTarget } from '../router/modelRouter.js';
+/** The index target of an `AgentTargetRef`; null for raw model refs (`config: ''`). */
+function targetRefTarget(ref) {
+    switch (ref.kind) {
+        case 'agent':
+            return { kind: 'agent', name: ref.name };
+        case 'team':
+            return { kind: 'team', name: ref.name };
+        case 'model':
+            // A raw legacy model ref (config: '') does not know its originating
+            // config, so it produces no config edge.
+            return ref.config ? { kind: 'config', name: ref.config } : null;
+    }
+}
+function pushTargetRefEdge(edges, from, field, ref) {
+    if (!ref)
+        return;
+    const to = targetRefTarget(ref);
+    if (to)
+        edges.push({ from, to, field });
+}
+function collectWorkflowNodeEdges(edges, from, node, pathPrefix) {
+    if (!node)
+        return;
+    if (node.type === 'agent') {
+        pushTargetRefEdge(edges, from, `${pathPrefix}${node.id}.targetRef`, node.targetRef);
+    }
+    for (const child of node.children ?? []) {
+        collectWorkflowNodeEdges(edges, from, child, pathPrefix);
+    }
+}
+/** Build every reference edge across the supplied definitions and active state. */
+export function buildReferenceIndex(input) {
+    const edges = [];
+    const agentNames = new Set((input.agentProfiles ?? []).map((profile) => profile.name));
+    // config ← agent profile.bridgeConfig
+    for (const profile of input.agentProfiles ?? []) {
+        if (!profile.bridgeConfig)
+            continue;
+        edges.push({
+            from: { kind: 'agent', name: profile.name },
+            to: { kind: 'config', name: profile.bridgeConfig },
+            field: 'bridgeConfig',
+        });
+    }
+    // config ← project Manager (manager.json bridgeConfig)
+    for (const manager of input.managerConfigs ?? []) {
+        if (!manager.bridgeConfig)
+            continue;
+        edges.push({
+            from: { kind: 'manager', name: manager.name },
+            to: { kind: 'config', name: manager.bridgeConfig },
+            field: 'bridgeConfig',
+        });
+    }
+    const assistantConfig = input.assistantConfig?.bridgeConfig?.trim();
+    if (assistantConfig) {
+        edges.push({
+            from: { kind: 'assistant', name: 'global' },
+            to: { kind: 'config', name: assistantConfig },
+            field: 'bridgeConfig',
+        });
+    }
+    for (const issue of input.issues ?? []) {
+        const agent = issue.agentConfig?.trim();
+        if (!agent)
+            continue;
+        edges.push({
+            from: { kind: 'issue', name: issue.id },
+            to: { kind: 'agent', name: agent },
+            field: 'agentConfig',
+        });
+    }
+    // agent/team/config ← router route targets + fallback (post-migration)
+    for (const router of input.routers ?? []) {
+        const from = { kind: 'router', name: router.name };
+        const routerModelTarget = router.routerModelTarget
+            ?? { kind: 'model', config: '', model: router.routerModel.model };
+        pushTargetRefEdge(edges, from, 'routerModelTarget', routerModelTarget);
+        router.routes.forEach((route, index) => {
+            const migrated = migrateRouterRouteTarget(route, agentNames);
+            pushTargetRefEdge(edges, from, `routes[${index}].target`, migrated.target);
+        });
+        const fallbackTarget = router.fallbackTarget
+            ?? (router.fallback ? { kind: 'model', config: '', model: router.fallback.model } : undefined);
+        pushTargetRefEdge(edges, from, 'fallbackTarget', fallbackTarget);
+    }
+    // team ← graph teamRef nodes / typed targetRefs (graph nodes + workflow tree)
+    for (const team of input.teams ?? []) {
+        const from = { kind: 'team', name: team.name };
+        for (const node of team.nodes ?? []) {
+            const nodeRef = node.id ?? node.name ?? node.role ?? '?';
+            const ref = node.targetRef
+                ?? (node.type === 'team' && node.teamRef
+                    ? { kind: 'team', name: node.teamRef }
+                    : undefined);
+            pushTargetRefEdge(edges, from, `nodes[${nodeRef}].${node.targetRef ? 'targetRef' : 'teamRef'}`, ref);
+        }
+        collectWorkflowNodeEdges(edges, from, team.workflowTree, 'workflowTree.');
+    }
+    // team ← automation tasks (Agent-page workflow squads referenced by name)
+    for (const task of input.automationTasks ?? []) {
+        if (task.kind !== 'workflow')
+            continue;
+        const name = task.workflowName?.trim();
+        if (!name)
+            continue;
+        edges.push({
+            from: { kind: 'automation', name: task.name || task.id },
+            to: task.workflowSource === 'agent'
+                ? { kind: 'team', name }
+                : { kind: 'workflow-script', name },
+            field: 'workflowName',
+        });
+    }
+    // team ← teamPreferences.defaultAttached
+    const defaultAttached = input.teamPreferences?.defaultAttached?.trim();
+    if (defaultAttached) {
+        edges.push({
+            from: { kind: 'preference', name: 'team.defaultAttached' },
+            to: { kind: 'team', name: defaultAttached },
+            field: 'defaultAttached',
+        });
+    }
+    // Active-state edges (composer/session activation) — distinct from.kind so
+    // the UI can distinguish them from definition-level references.
+    const session = input.session;
+    if (session) {
+        const from = { kind: 'session', name: 'active' };
+        if (session.activeAgent?.trim()) {
+            edges.push({ from, to: { kind: 'agent', name: session.activeAgent.trim() }, field: 'activeAgent' });
+        }
+        if (session.activeConfig?.trim()) {
+            edges.push({ from, to: { kind: 'config', name: session.activeConfig.trim() }, field: 'activeConfig' });
+        }
+        if (session.activeRouterName?.trim()) {
+            edges.push({ from, to: { kind: 'router', name: session.activeRouterName.trim() }, field: 'activeRouterName' });
+        }
+        if (session.activeTeamName?.trim()) {
+            edges.push({ from, to: { kind: 'team', name: session.activeTeamName.trim() }, field: 'activeTeamName' });
+        }
+    }
+    return edges;
+}
+/** "Who uses this definition?" — all edges pointing at `kind`/`name`. */
+export function findUsages(index, kind, name) {
+    return index.filter((edge) => edge.to.kind === kind && edge.to.name === name);
+}
+/**
+ * "Is what I reference still there?" — edges whose target name is absent from
+ * the known set for that target kind. A target kind whose set is omitted from
+ * `known` is not reported (unknown ≠ broken).
+ */
+export function findBrokenRefs(index, known) {
+    const sets = {
+        config: known.configs ? new Set(known.configs) : undefined,
+        agent: known.agents ? new Set(known.agents) : undefined,
+        team: known.teams ? new Set(known.teams) : undefined,
+        router: known.routers ? new Set(known.routers) : undefined,
+        'workflow-script': known.workflows ? new Set(known.workflows) : undefined,
+    };
+    return index.filter((edge) => {
+        const set = sets[edge.to.kind];
+        return set ? !set.has(edge.to.name) : false;
+    });
+}
+//# sourceMappingURL=referenceIndex.js.map

package/dist/src/manager/referenceIndex.js.map

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

package/dist/src/manager/referenceOperations.d.ts

@@ -0,0 +1,108 @@
+import type { RouterProfile, TeamDefinition } from '../types.js';
+import type { TeamPreferences } from '../team/teamPreferences.js';
+export type ReferenceDefinitionKind = 'config' | 'agent' | 'router' | 'team';
+/** Force-delete fallback strategy chosen in the impact dialog. */
+export type DeleteFallbackStrategy = 
+/** Leave references pointing at the deleted name (they show as broken). */
+{
+    type: 'leave';
+}
+/** config → another config; agent → another agent. */
+ | {
+    type: 'repoint';
+    target: string;
+}
+/** agent → degrade references to a raw model ref keeping the model name. */
+ | {
+    type: 'degrade-model';
+}
+/** team → remove referencing graph nodes (and their edges) from other teams. */
+ | {
+    type: 'remove-nodes';
+};
+export interface ReferenceOperationContext {
+    /** Project directory (workDir) for project-scoped routers/teams/automations. */
+    projectDir?: string;
+    homeDir?: string;
+    /** Project path whose manager.json participates; defaults to projectDir. */
+    managerProjectPath?: string;
+    /** Accessor for teamPreferences.defaultAttached rewrites (settings.json). */
+    teamPreferences?: {
+        read(): TeamPreferences;
+        write(prefs: TeamPreferences): void | Promise<void>;
+    };
+    /** Issue-store adapter used to rewrite `agentConfig` across file/SQLite modes. */
+    issues?: {
+        read(): Promise<Array<{
+            id: string;
+            number?: number;
+            agentConfig?: string;
+        }>>;
+        writeAgentConfig(id: string, agentConfig: string | null): Promise<void>;
+    };
+    /** Global Assistant config adapter used to rewrite `bridgeConfig`. */
+    assistantConfig?: {
+        read(): Promise<{
+            bridgeConfig?: string;
+        }>;
+        write(config: {
+            bridgeConfig?: string;
+        }): Promise<void>;
+    };
+}
+export interface ReferenceOperationReport {
+    /** Human-readable descriptions of every rewritten reference. */
+    rewritten: string[];
+}
+/**
+ * Rewrite references inside a raw router profile JSON. `agentNames` are the
+ * pre-rename saved profile names, used to recognize legacy role/name-matched
+ * routes (their implicit agent reference follows the rename).
+ * Returns true when anything changed.
+ */
+export declare function rewriteRouterFileRefs(raw: RouterProfile, kind: ReferenceDefinitionKind, oldName: string, newName: string, agentNames: ReadonlySet<string>): boolean;
+/** Rewrite references inside a raw team definition JSON. Returns true when changed. */
+export declare function rewriteTeamFileRefs(raw: TeamDefinition, kind: ReferenceDefinitionKind, oldName: string, newName: string): boolean;
+/** Degrade agent references in a raw router profile to raw model refs. Returns changed flag. */
+export declare function degradeAgentRefsInRouter(raw: RouterProfile, agentName: string, model: string): boolean;
+/** Strip agent targetRefs from a raw team definition (legacy model fields remain). */
+export declare function removeAgentRefsInTeam(raw: TeamDefinition, agentName: string): boolean;
+/**
+ * Remove graph nodes that invoke the given team (legacy `teamRef` or typed
+ * `targetRef`) plus their incident edges. Workflow-tree nodes keep the node
+ * and lose only the targetRef (tree surgery would change semantics).
+ */
+export declare function removeTeamRefNodes(raw: TeamDefinition, teamName: string): boolean;
+/**
+ * Rename a config / agent / router / team and rewrite every reference the
+ * index knows about. Referencers are written first, the definition itself
+ * last; any failure restores the original bytes of every touched file.
+ */
+export declare function renameDefinitionAndReferences(kind: ReferenceDefinitionKind, oldName: string, newName: string, ctx?: ReferenceOperationContext): Promise<ReferenceOperationReport>;
+/**
+ * Rewrite referencers ahead of a force-delete. The definition deletion itself
+ * stays with the calling endpoint. `leave` is a no-op by design — the broken
+ * references stay visible via the reference index and ⚠ badges.
+ */
+export declare function applyDeleteFallback(kind: ReferenceDefinitionKind, name: string, strategy: DeleteFallbackStrategy, ctx?: ReferenceOperationContext): Promise<ReferenceOperationReport>;
+/**
+ * Convert-on-save for legacy single-agent squads (squadType 'agent'). The
+ * caller has already written the unified .md agent; this removes the squad
+ * json (built-in presets are immutable — skipped, the .md shadows them) and
+ * rewires references P1-style:
+ *  - team graph/workflow nodes invoking the squad (legacy teamRef or typed
+ *    targetRef kind 'team') become { kind: 'agent' } targetRefs;
+ *  - teamPreferences.defaultAttached pointing at the squad is cleared (an
+ *    agent cannot be attached as a team);
+ *  - automation tasks keep their workflowName — the reference goes broken
+ *    on purpose (visible via the index ⚠ badges), matching 'leave'.
+ */
+export declare function convertAgentSquadToAgentDefinition(squadName: string, agentName: string, ctx?: ReferenceOperationContext): Promise<ReferenceOperationReport>;
+/**
+ * Re-point every typed reference to `configName`'s `fromModel` onto
+ * `toModel` (same config). Used when a model is removed from a config:
+ * agent profiles (bridgeConfig+model), router route/fallback targets, and
+ * team node targetRefs.
+ */
+export declare function repointConfigModel(configName: string, fromModel: string, toModel: string, ctx?: ReferenceOperationContext): Promise<ReferenceOperationReport>;
+//# sourceMappingURL=referenceOperations.d.ts.map

package/dist/src/manager/referenceOperations.d.ts.map

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