@gaia-ai/core 0.5.5 → 0.6.1

package/dist/src/plugins/workspace/git.js

@@ -1,89 +0,0 @@
-import { existsSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
-import { exec } from '../../core/exec.js';
-import { slugify } from '../../core/slug.js';
-import { loadInstructions } from './instructions.js';
-/** Default branch template: `<prefix><key>-<title-slug>` (readable). */
-export const DEFAULT_BRANCH_TEMPLATE = '{branchPrefix}{key}-{titleSlug}';
-function renderBranchTemplate(template, vars) {
-    const rendered = template.replace(/\{(\w+)\}/g, (whole, key) => {
-        const value = vars[key];
-        return value === undefined ? whole : value;
-    });
-    // An empty title slug leaves a dangling separator (e.g. `gaia/GL-9-`) —
-    // trim trailing branch separators so the branch stays a valid, tidy ref.
-    return rendered.replace(/[-_./]+$/g, '');
-}
-const defaultGitRunner = async (args, cwd) => {
-    await exec('git', args, { cwd });
-};
-export class GitWorkspace {
-    runGit;
-    root;
-    worktreesRoot;
-    branchPrefix;
-    branchTemplate;
-    constructor(options) {
-        this.runGit = options.runGit ?? defaultGitRunner;
-        this.root = resolve(options.root);
-        this.worktreesRoot = options.worktreesRoot
-            ? resolve(options.worktreesRoot)
-            : `${this.root}-worktrees`;
-        this.branchPrefix = options.branchPrefix ?? 'gaia/';
-        this.branchTemplate = options.branchTemplate ?? DEFAULT_BRANCH_TEMPLATE;
-    }
-    /** Render the branch name for a ticket from the configured template. */
-    branchFor(identifier, title) {
-        return renderBranchTemplate(this.branchTemplate, {
-            branchPrefix: this.branchPrefix,
-            key: this.keyFor(identifier),
-            identifier,
-            titleSlug: slugify(title ?? ''),
-        });
-    }
-    keyFor(identifier) {
-        return identifier.replace(/[^A-Za-z0-9._-]/g, '_');
-    }
-    pathFor(key) {
-        return resolve(join(this.worktreesRoot, key));
-    }
-    async ensure(identifier, title, _baseRef) {
-        const key = this.keyFor(identifier);
-        // Reject empty and dot-leading keys: a dot-leading key would produce an
-        // invalid git ref (e.g. `gaia/.hidden`) and covers '.'/'..' too.
-        if (key === '' || key.startsWith('.')) {
-            throw new Error(`invalid workspace identifier: ${identifier}`);
-        }
-        const path = this.pathFor(key);
-        if (existsSync(path)) {
-            return { path, instructions: loadInstructions(path), created: false };
-        }
-        const branch = this.branchFor(identifier, title);
-        await this.runGit(['-C', this.root, 'worktree', 'add', '--force', '-B', branch, path], this.root);
-        // The `after_create` hook is run by the executor (GAIA-84), not here — the
-        // workspace only reports that it created a fresh worktree.
-        return { path, instructions: loadInstructions(path), created: true };
-    }
-    async remove(identifier) {
-        const key = this.keyFor(identifier);
-        const path = this.pathFor(key);
-        await this.runGit(['-C', this.root, 'worktree', 'remove', '--force', path], this.root);
-    }
-}
-export function gitWorkspace(opts = {}) {
-    return {
-        kind: 'workspace',
-        id: 'git',
-        requiredModules: [],
-        async createWorkspace(config) {
-            const root = config.config_path
-                ? dirname(config.config_path)
-                : process.cwd();
-            return new GitWorkspace({
-                root,
-                ...(opts.branchPrefix ? { branchPrefix: opts.branchPrefix } : {}),
-                ...(opts.branchTemplate ? { branchTemplate: opts.branchTemplate } : {}),
-            });
-        },
-    };
-}

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

@@ -1,6 +0,0 @@
-/** Loads ./WORKFLOW.md from the workspace, hashing its content. */
-export declare function loadInstructions(workspacePath: string): {
-    path: string;
-    sha256: string;
-    text: string;
-} | null;

package/dist/src/plugins/workspace/instructions.js

@@ -1,16 +0,0 @@
-import { createHash } from 'node:crypto';
-import { existsSync, readFileSync } from 'node:fs';
-import { resolve } from 'node:path';
-/** Loads ./WORKFLOW.md from the workspace, hashing its content. */
-export function loadInstructions(workspacePath) {
-    const path = resolve(workspacePath, 'WORKFLOW.md');
-    if (!existsSync(path)) {
-        return null;
-    }
-    const text = readFileSync(path, 'utf8');
-    return {
-        path,
-        sha256: createHash('sha256').update(text).digest('hex'),
-        text,
-    };
-}

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

@@ -1,35 +0,0 @@
-export interface EnsuredWorkspace {
-    path: string;
-    instructions: {
-        path: string;
-        sha256: string;
-        text: string;
-    } | null;
-    /**
-     * Whether this call CREATED the worktree (true) or reused an existing one
-     * (false). The core runs the `after_create` lifecycle hook only on a fresh
-     * worktree, so it needs to know which happened. Lifecycle hooks themselves
-     * are no longer a workspace concern (GAIA-84): the executor owns and runs
-     * them best-effort.
-     */
-    created: boolean;
-}
-export interface GaiaWorkspace {
-    /**
-     * Ensure a per-ticket worktree exists. `branch`, when given, is the branch
-     * name the dispatcher computed for the ticket. The git plugin treats it as a
-     * readable title to slug into its branch template; the herdr plugin uses it
-     * verbatim as the worktree branch. The worktree directory key/path stays
-     * identifier- or branch-derived so reuse is stable across runs.
-     *
-     * `baseRef`, when given, overrides the base the new branch is created from
-     * (e.g. `origin/<base_branch>` so a sub-ticket stacks on its parent); if it
-     * does not resolve on the remote the implementation falls back to its default
-     * base — never a hard error.
-     *
-     * Reports `created` so the caller can run the `after_create` hook only on a
-     * fresh worktree. Lifecycle-hook invocation is NOT a workspace responsibility
-     * anymore — the executor owns all hooks (GAIA-84).
-     */
-    ensure(identifier: string, branch?: string, baseRef?: string): Promise<EnsuredWorkspace>;
-}

package/dist/src/plugins/workspace/workspace.js

@@ -1 +0,0 @@
-export {};

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

@@ -1 +0,0 @@
-export * from './plugins/registry-exports.js';

package/dist/src/plugins-index.js

@@ -1 +0,0 @@
-export * from './plugins/registry-exports.js';

package/dist/src/types.d.ts

@@ -1,52 +0,0 @@
-import type { DropSHPlugin } from 'dropsh/plugin';
-import type { AgentCandidate, ExecutorPlugin, RemotePlugin, WorkspacePlugin } from './plugins/plugins.js';
-/** Normalized single conductor. */
-export interface ConductorSettings {
-    /** Default: `${project} @ ${checkoutRoot}`. */
-    label: string;
-    /**
-     * Stable node identity (gaia_conductor.machine_id) this process registers as.
-     * Defaults to a hash of hostname + checkout path. Set it to pin a conductor to
-     * a known identity — e.g. so a ticket can be pre-assigned to it (conductor
-     * assignment is the run-start trigger), which the e2e fixtures rely on.
-     */
-    machine_id?: string;
-    /** Project name (gaia_project.name); resolved at registration. */
-    project: string;
-    /** Workflow states this conductor serves. */
-    states: string[];
-    /**
-     * Agent prompt template - the GAIA run contract, NOT project workflow. Bounds
-     * the agent to exactly one state and tells it to release + stop, keeping run
-     * mechanics out of the repo's WORKFLOW.md. Placeholders: `{identifier}`,
-     * `{state}`, `{runUuid}`. Defaults to `DEFAULT_AGENT_PROMPT`.
-     */
-    prompt: string;
-    /** Default: 1. */
-    max_parallel: number;
-    poll_interval_ms: number;
-    lease_seconds: number;
-    hooks?: {
-        after_create?: string;
-        before_run?: string;
-        after_run?: string;
-        after_done?: string;
-    };
-    /** Control-plane site settings used for dropsh and agent env. */
-    site: {
-        base_url: string;
-        jsonapi_prefix: string;
-    };
-    /** Absolute path of the loaded config. */
-    config_path: string;
-}
-/** Whole conductor.config.js (dropsh-superset): site + named plugin slots. */
-export interface ConductorFileConfig extends ConductorSettings {
-    remote: RemotePlugin;
-    executor: ExecutorPlugin;
-    /** 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/dist/src/types.js

@@ -1 +0,0 @@
-export {};