@gaia-ai/core 0.4.7 → 0.5.3

package/dist/src/index.d.ts

@@ -5,7 +5,8 @@ export { shellQuote } from './core/shell.js';
 export { DEFAULT_SLUG_MAX_LENGTH, slugify } from './core/slug.js';
 export { type AgentFootprint, emptyAgentFootprint, type GaiaAgent, } from './plugins/agent/agent.js';
 export type * from './plugins/executor/executor.js';
-export type { AgentPlugin, ExecutorDeps, ExecutorPlugin, RemotePlugin, WorkspacePlugin, } from './plugins/plugins.js';
+export type { AgentCandidate, AgentPlugin, ExecutorDeps, ExecutorPlugin, RemotePlugin, ResolvedAgent, WorkspacePlugin, } from './plugins/plugins.js';
+export { selectAgent, selectAgents } from './plugins/plugins.js';
 export type * from './plugins/remote/remote.js';
 export { loadInstructions } from './plugins/workspace/instructions.js';
 export type { EnsuredWorkspace, GaiaWorkspace, } from './plugins/workspace/workspace.js';

package/dist/src/index.js

@@ -4,4 +4,5 @@ export { createLogger } from './core/logger.js';
 export { shellQuote } from './core/shell.js';
 export { DEFAULT_SLUG_MAX_LENGTH, slugify } from './core/slug.js';
 export { emptyAgentFootprint, } from './plugins/agent/agent.js';
+export { selectAgent, selectAgents } from './plugins/plugins.js';
 export { loadInstructions } from './plugins/workspace/instructions.js';

package/dist/src/plugins/plugins.d.ts

@@ -3,7 +3,7 @@ import type { ConductorLogger } from '../core/logger.js';
 import type { ConductorFileConfig } from '../types.js';
 import type { GaiaAgent } from './agent/agent.js';
 import type { GaiaExecutor } from './executor/executor.js';
-import type { GaiaRemote } from './remote/remote.js';
+import type { GaiaRemote, Ticket } from './remote/remote.js';
 import type { GaiaWorkspace } from './workspace/workspace.js';
 /** Runtime dependencies handed to a plugin factory at selection time. */
 export interface ExecutorDeps {
@@ -40,5 +40,21 @@ export declare function selectRemote(config: ConductorFileConfig): Promise<GaiaR
 export declare function selectExecutor(config: ConductorFileConfig, logger: ConductorLogger): Promise<GaiaExecutor>;
 /** Resolves the workspace from its named config slot. */
 export declare function selectWorkspace(config: ConductorFileConfig): Promise<GaiaWorkspace>;
-/** Resolves the agent from its named config slot. */
-export declare function selectAgent(config: ConductorFileConfig): Promise<GaiaAgent>;
+/** A config-side agent choice: an agent plugin + an optional static priority over the ticket. */
+export interface AgentCandidate {
+    agent: AgentPlugin;
+    priority?: (ticket: Ticket) => number;
+}
+/** A constructed candidate: the agent id, its GaiaAgent, and the config-side priority. */
+export interface ResolvedAgent {
+    id: string;
+    agent: GaiaAgent;
+    priority?: (ticket: Ticket) => number;
+}
+/**
+ * Pick the agent for a ticket: highest `priority(ticket)` wins; a candidate with
+ * no `priority` scores lowest; ties resolve by config array order (stable sort).
+ */
+export declare function selectAgent(candidates: ResolvedAgent[], ticket: Ticket): ResolvedAgent;
+/** Constructs every agent candidate from the resolved config slot (single or array). */
+export declare function selectAgents(config: ConductorFileConfig): Promise<ResolvedAgent[]>;

package/dist/src/plugins/plugins.js

@@ -10,7 +10,33 @@ export async function selectExecutor(config, logger) {
 export async function selectWorkspace(config) {
     return config.workspace.createWorkspace(config);
 }
-/** Resolves the agent from its named config slot. */
-export async function selectAgent(config) {
-    return config.agent.createAgent(config);
+/** A missing `priority` scores strictly below any real number (AC-4). */
+const DEFAULT_PRIORITY = Number.NEGATIVE_INFINITY;
+/**
+ * Pick the agent for a ticket: highest `priority(ticket)` wins; a candidate with
+ * no `priority` scores lowest; ties resolve by config array order (stable sort).
+ */
+export function selectAgent(candidates, ticket) {
+    const best = candidates
+        .map((c, index) => ({
+        c,
+        index,
+        score: c.priority ? c.priority(ticket) : DEFAULT_PRIORITY,
+    }))
+        .sort((a, b) => b.score - a.score || a.index - b.index)[0];
+    if (!best) {
+        throw new Error('selectAgent: no agent candidates configured');
+    }
+    return best.c;
+}
+/** Constructs every agent candidate from the resolved config slot (single or array). */
+export async function selectAgents(config) {
+    const candidates = Array.isArray(config.agent)
+        ? config.agent
+        : [config.agent];
+    return Promise.all(candidates.map(async (c) => ({
+        id: c.agent.id,
+        agent: await c.agent.createAgent(config),
+        ...(c.priority ? { priority: c.priority } : {}),
+    })));
 }

package/dist/src/plugins/registry-exports.d.ts

@@ -1,5 +1,5 @@
 export { basicAuthProvider } from './auth/basic.js';
-export { selectAgent, selectExecutor, selectRemote, selectWorkspace, } from './plugins.js';
+export { type AgentCandidate, type ResolvedAgent, selectAgent, selectAgents, selectExecutor, selectRemote, selectWorkspace, } from './plugins.js';
 export { DrupalGaiaRemote, drupalRemote } from './remote/drupal.js';
 export { FakeGaiaRemote, type FakeRemoteSeed, fakeRemote, } from './remote/fake.js';
 export { FakeWorkspace, fakeWorkspace } from './workspace/fake.js';

package/dist/src/plugins/registry-exports.js

@@ -1,5 +1,5 @@
 export { basicAuthProvider } from './auth/basic.js';
-export { selectAgent, selectExecutor, selectRemote, selectWorkspace, } from './plugins.js';
+export { selectAgent, selectAgents, selectExecutor, selectRemote, selectWorkspace, } from './plugins.js';
 export { DrupalGaiaRemote, drupalRemote } from './remote/drupal.js';
 export { FakeGaiaRemote, fakeRemote, } from './remote/fake.js';
 export { FakeWorkspace, fakeWorkspace } from './workspace/fake.js';

package/dist/src/plugins/remote/drupal.js

@@ -68,11 +68,30 @@ export class DrupalGaiaRemote {
     }
     async getTicket(uuid) {
         // The agent self-reads the ticket + its comments at run start (GAIA-112),
-        // so getTicket only needs the ticket's own attributes for dispatch — no
-        // ?include=comments sideload.
-        const doc = (await this.api.get(`gaia_ticket/gaia_ticket/${uuid}`));
+        // so getTicket needs no ?include=comments — but it DOES sideload labels +
+        // environments (GAIA-144) so a config-side priority(ticket) can read them
+        // without fetching (AC-5).
+        const doc = (await this.api.get(`gaia_ticket/gaia_ticket/${uuid}?include=labels,environments`));
         const attrs = doc.data?.attributes ?? {};
         const issueUrl = typeof attrs.origin === 'string' ? attrs.origin : undefined;
+        const included = Array.isArray(doc.included) ? doc.included : [];
+        const byId = new Map(included.map((r) => [`${r.type}:${r.id}`, r]));
+        const refs = (name) => {
+            const data = doc.data?.relationships?.[name]?.data;
+            return Array.isArray(data) ? data : [];
+        };
+        const labels = refs('labels')
+            .map((ref) => byId.get(`${ref.type}:${ref.id}`)?.attributes?.name)
+            .filter((n) => typeof n === 'string');
+        const environments = refs('environments')
+            .map((ref) => {
+            const a = byId.get(`${ref.type}:${ref.id}`)?.attributes ?? {};
+            return {
+                name: typeof a.name === 'string' ? a.name : '',
+                tier: typeof a.tier === 'string' ? a.tier : '',
+            };
+        })
+            .filter((e) => e.name !== '');
         return {
             uuid: doc.data?.id ?? uuid,
             identifier: typeof attrs.identifier === 'string' ? attrs.identifier : uuid,
@@ -87,6 +106,8 @@ export class DrupalGaiaRemote {
                 ? { effectiveEnvVars: attrs.effective_env_vars }
                 : {}),
             ...(issueUrl ? { issueUrl } : {}),
+            labels,
+            environments,
         };
     }
     async getRunWorktree(uuid) {
@@ -195,6 +216,7 @@ export class DrupalGaiaRemote {
                 state: 'running',
                 heartbeat: t,
                 ...(attrs?.worktree_path ? { worktree_path: attrs.worktree_path } : {}),
+                ...(attrs?.agent ? { agent: attrs.agent } : {}),
             },
         });
     }
@@ -204,7 +226,7 @@ export class DrupalGaiaRemote {
             .where('conductor_id.machine_id', '=', id)
             .where('state', '=', 'done')
             .where('closed', '=', '0')
-            .fields(['worktree_path', 'started_at'])
+            .fields(['worktree_path', 'started_at', 'agent'])
             .page(100)
             .list();
         return rows.map((r) => {
@@ -213,6 +235,7 @@ export class DrupalGaiaRemote {
                 runUuid: r.id,
                 worktreePath: r.attr('worktree_path') ?? '',
                 ...(typeof startedAt === 'number' ? { startedAt } : {}),
+                agent: r.attr('agent') ?? '',
             };
         });
     }

package/dist/src/plugins/remote/fake.d.ts

@@ -13,6 +13,8 @@ export interface FakeSeedRun {
     closed?: boolean;
     /** Unix timestamp (seconds) the run started — drives footprint duration_s. */
     startedAt?: number;
+    /** Id of the agent that ran (GAIA-144) — routes footprint parsing at finalize. */
+    agent?: string;
 }
 export interface FakeSeedTicket {
     identifier: string;
@@ -25,6 +27,13 @@ export interface FakeSeedTicket {
     effectiveEnvVars?: string;
     url?: string;
     workflow?: string;
+    /** Label term names sideloaded for agent selection (GAIA-144). */
+    labels?: string[];
+    /** Environments sideloaded for agent selection (GAIA-144). */
+    environments?: {
+        name: string;
+        tier: string;
+    }[];
     /** Whether the ticket is already closed (its lifecycle wound up). */
     closed?: boolean;
     /** Whether the ticket's worktree is already torn down (cleaned_up flag). */
@@ -44,6 +53,7 @@ export interface MarkRunningCall {
     runUuid: string;
     attrs?: {
         worktree_path?: string;
+        agent?: string;
     };
 }
 export interface FinalizeRunCall {

package/dist/src/plugins/remote/fake.js

@@ -34,6 +34,7 @@ export class FakeGaiaRemote {
                     ? { worktreePath: r.worktreePath }
                     : {}),
                 ...(r.startedAt !== undefined ? { startedAt: r.startedAt } : {}),
+                ...(r.agent !== undefined ? { agent: r.agent } : {}),
                 ...(r.closed !== undefined ? { closed: r.closed } : {}),
             });
             this.queue.push({
@@ -104,6 +105,8 @@ export class FakeGaiaRemote {
             ...(t.baseBranch ? { baseBranch: t.baseBranch } : {}),
             ...(t.effectiveEnvVars ? { effectiveEnvVars: t.effectiveEnvVars } : {}),
             ...(t.url ? { issueUrl: t.url } : {}),
+            labels: t.labels ?? [],
+            environments: t.environments ?? [],
         };
     }
     async getRunWorktree(runUuid) {
@@ -136,6 +139,7 @@ export class FakeGaiaRemote {
                         ...(attrs.worktree_path
                             ? { worktree_path: attrs.worktree_path }
                             : {}),
+                        ...(attrs.agent ? { agent: attrs.agent } : {}),
                     },
                 }
                 : {}),
@@ -146,6 +150,9 @@ export class FakeGaiaRemote {
             if (attrs?.worktree_path) {
                 run.worktreePath = attrs.worktree_path;
             }
+            if (attrs?.agent) {
+                run.agent = attrs.agent;
+            }
         }
     }
     async fetchFinalizableRuns(_conductorId) {
@@ -155,6 +162,7 @@ export class FakeGaiaRemote {
             runUuid: r.runUuid,
             worktreePath: r.worktreePath ?? '',
             ...(r.startedAt !== undefined ? { startedAt: r.startedAt } : {}),
+            agent: r.agent ?? '',
         }));
     }
     async finalizeRun(runUuid, log, metrics) {

package/dist/src/plugins/remote/remote.d.ts

@@ -34,6 +34,13 @@ export interface Ticket {
      */
     effectiveEnvVars?: string;
     issueUrl?: string;
+    /** Ticket label term names (gaia_labels vocab), sideloaded for agent selection. Empty when none. */
+    labels: string[];
+    /** Ticket environments (gaia_environment refs), each as name + tier, sideloaded for agent selection. Empty when none. */
+    environments: {
+        name: string;
+        tier: string;
+    }[];
 }
 export interface ActiveRun {
     runUuid: string;
@@ -63,6 +70,8 @@ export interface FinalizableRun {
      * (GAIA-132).
      */
     startedAt?: number;
+    /** Id of the agent that ran (GAIA-144); routes footprint parsing at finalize. '' / undefined when unset. */
+    agent?: string;
 }
 /**
  * Per-run effort footprint the conductor writes onto `gaia_run` at close
@@ -103,6 +112,8 @@ export interface UncleanTicket {
 export interface RunWriteAttributes {
     /** Absolute path of the per-run git worktree (set by the conductor). */
     worktree_path?: string;
+    /** Id of the agent the conductor chose for this run (GAIA-144), for footprint routing. */
+    agent?: string;
 }
 export interface GaiaRemote {
     /** Upserts by machine_id; sets status=online. Returns the Drupal entity uuid. */

package/dist/src/types.d.ts

@@ -1,5 +1,5 @@
 import type { DropSHPlugin } from 'dropsh/plugin';
-import type { AgentPlugin, ExecutorPlugin, RemotePlugin, WorkspacePlugin } from './plugins/plugins.js';
+import type { AgentCandidate, ExecutorPlugin, RemotePlugin, WorkspacePlugin } from './plugins/plugins.js';
 /** Normalized single conductor. */
 export interface ConductorSettings {
     /** Default: `${project} @ ${checkoutRoot}`. */
@@ -44,7 +44,8 @@ export interface ConductorSettings {
 export interface ConductorFileConfig extends ConductorSettings {
     remote: RemotePlugin;
     executor: ExecutorPlugin;
-    agent: AgentPlugin;
+    /** The agent slot: a single candidate or an array of candidates (shape preserved as authored). Selection normalizes + picks one per dispatch. */
+    agent: AgentCandidate | AgentCandidate[];
     workspace: WorkspacePlugin;
     /** dropsh-layer plugins (auth etc.); separate from the GAIA slots. */
     plugins?: DropSHPlugin[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaia-ai/core",
-  "version": "0.4.7",
+  "version": "0.5.3",
   "description": "GAIA global contract: plugin API, built-in remotes/workspaces/auth, shared primitives.",
   "type": "module",
   "license": "MIT",