@agents-ensemble/operator-agent 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 otolab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { runOperatorAgent } from './run-operator-agent.js';
+export type { OperatorAgentInput, OperatorAgentOutput, RunOperatorAgentDependencies, RunOperatorAgentOptions, } from './run-operator-agent.js';
+export { createListOperatorSessionsTool, LIST_OPERATOR_SESSIONS_TOOL, } from './list-operator-sessions-tool.js';
+export { operatorBaseModule } from './operator-base-module.js';
+export type { OperatorPromptContext } from './operator-base-module.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { runOperatorAgent } from './run-operator-agent.js';
+export { createListOperatorSessionsTool, LIST_OPERATOR_SESSIONS_TOOL, } from './list-operator-sessions-tool.js';
+export { operatorBaseModule } from './operator-base-module.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAO3D,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,GAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/list-operator-sessions-tool.d.ts

@@ -0,0 +1,5 @@
+import { type ConductorTool } from '@agents-ensemble/core/operator-runtime';
+export declare const LIST_OPERATOR_SESSIONS_TOOL = "list_operator_sessions";
+/** Build a read-only tool over this repository's existing conductor sidecars. */
+export declare function createListOperatorSessionsTool(repoRoot: string): ConductorTool;
+//# sourceMappingURL=list-operator-sessions-tool.d.ts.map

package/dist/list-operator-sessions-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-operator-sessions-tool.d.ts","sourceRoot":"","sources":["../src/list-operator-sessions-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,aAAa,EAEnB,MAAM,wCAAwC,CAAC;AAEhD,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AAsBpE,iFAAiF;AACjF,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CA2C9E"}

package/dist/list-operator-sessions-tool.js

@@ -0,0 +1,85 @@
+import { resolve } from 'node:path';
+import { listSessionSidecars, } from '@agents-ensemble/core/operator-runtime';
+export const LIST_OPERATOR_SESSIONS_TOOL = 'list_operator_sessions';
+const DEFAULT_LIMIT = 20;
+const MAX_LIMIT = 50;
+/** Build a read-only tool over this repository's existing conductor sidecars. */
+export function createListOperatorSessionsTool(repoRoot) {
+    const root = resolve(repoRoot);
+    return {
+        name: LIST_OPERATOR_SESSIONS_TOOL,
+        description: 'Read saved conductor session sidecars under <repoRoot>/.ensemble/sessions and return a concise summary.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: {
+                    type: 'integer',
+                    minimum: 1,
+                    maximum: MAX_LIMIT,
+                    description: `Maximum number of recent sessions to return (default ${DEFAULT_LIMIT}).`,
+                },
+            },
+            additionalProperties: false,
+        },
+        execute: async (args) => {
+            const limit = resolveLimit(args.limit);
+            const sidecars = await listSessionSidecars(root);
+            sidecars.sort((left, right) => right.updatedAt - left.updatedAt);
+            const sessions = sidecars
+                .slice(0, limit)
+                .map(summarizeSession);
+            const payload = {
+                repoRoot: root,
+                total: sidecars.length,
+                returned: sessions.length,
+                sessions,
+            };
+            const structuredContent = payload;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(payload, null, 2),
+                    },
+                ],
+                structuredContent,
+            };
+        },
+    };
+}
+function resolveLimit(value) {
+    if (value === undefined)
+        return DEFAULT_LIMIT;
+    if (typeof value !== 'number' ||
+        !Number.isInteger(value) ||
+        value < 1 ||
+        value > MAX_LIMIT) {
+        throw new Error(`limit must be an integer between 1 and ${MAX_LIMIT}`);
+    }
+    return value;
+}
+function summarizeSession(sidecar) {
+    return {
+        agentId: sidecar.conductorAgentId,
+        issueUrl: sidecar.issueUrl,
+        conductorBackend: sidecar.conductorBackend ?? 'cursor',
+        profile: sidecar.profile.meta?.title ??
+            sidecar.profilePath ??
+            'unknown',
+        updatedAt: sidecar.updatedAt,
+        workers: Object.keys(sidecar.workers).sort(),
+        openQuestions: sidecar.openQuestions
+            .filter((question) => question.status === 'open')
+            .map((question) => ({
+            id: question.id,
+            question: question.question,
+            responseType: question.responseType,
+            ...(question.context ? { context: question.context } : {}),
+            ...(question.relatedPermissionId
+                ? { relatedPermissionId: question.relatedPermissionId }
+                : {}),
+        })),
+        answeredQuestionCount: sidecar.openQuestions.filter((question) => question.status === 'answered').length,
+    };
+}
+//# sourceMappingURL=list-operator-sessions-tool.js.map

package/dist/list-operator-sessions-tool.js.map

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

package/dist/operator-base-module.d.ts

@@ -0,0 +1,14 @@
+import type { PromptModule } from '@modular-prompt/core';
+import type { ConductorBackend } from '@agents-ensemble/core/operator-runtime';
+export interface OperatorPromptContext {
+    repoRoot: string;
+    conductorBackend: ConductorBackend;
+    profileName: string;
+    workers: Array<{
+        name: string;
+        kind: string;
+    }>;
+}
+/** The operator role has its own voice and does not inherit conductor instructions. */
+export declare const operatorBaseModule: PromptModule<OperatorPromptContext>;
+//# sourceMappingURL=operator-base-module.d.ts.map

package/dist/operator-base-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-base-module.d.ts","sourceRoot":"","sources":["../src/operator-base-module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE/E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD;AAED,uFAAuF;AACvF,eAAO,MAAM,kBAAkB,EAAE,YAAY,CAAC,qBAAqB,CAmDlE,CAAC"}

package/dist/operator-base-module.js

@@ -0,0 +1,50 @@
+/** The operator role has its own voice and does not inherit conductor instructions. */
+export const operatorBaseModule = {
+    persona: [
+        'あなたは agents-ensemble の operator ロールを担う operator-agent です。',
+        'user と密に対話し、保存された Issue セッション情報を材料に、横断的な状況把握と判断を支援してください。',
+    ],
+    objective: [
+        'user が conductor と worker の状況を理解し、次の判断を行えるよう支援する。',
+    ],
+    terms: [
+        '- **operator**: user を支援し、conductor と workers を横断して監督する役割',
+        '- **session sidecar**: `.ensemble/sessions/` に保存された conductor セッションの状態ファイル',
+    ],
+    methodology: [
+        'user は operator-agent と対話し、operator-agent は保存済みのセッション情報を介して conductor の状況を把握する。',
+        'operator-agent と conductor の間に同期接続はなく、worker へ直接指示する経路もない。',
+    ],
+    instructions: [
+        '状況を尋ねられたら `list_operator_sessions` を使い、保存済み sidecar に含まれる情報と取得時点を明示してください。',
+        'sidecar にない稼働状況や最新の GitHub 情報を推測せず、確認できない点を user に伝えてください。',
+        '作業や conductor への連絡を実行したと主張せず、判断に必要な事実・選択肢・不確実な点を簡潔に整理してください。',
+        'profile の operator 向け追加指示と Prepared Materials があれば、それに従ってください。',
+        {
+            type: 'subsection',
+            title: 'list_operator_sessions',
+            items: [
+                '- `.ensemble/sessions/` の sidecar 一覧と要約を読む読み取り専用ツールです',
+                '- Issue URL、conductor backend、profile、worker 名、open question の要約、更新時刻を返します',
+                '- `limit` は返却する件数（1〜50、既定 20）です',
+            ],
+        },
+    ],
+    state: [
+        (context) => `- repository: \`${context.repoRoot}\``,
+        (context) => `- conductor backend: \`${context.conductorBackend}\``,
+        (context) => `- team profile: ${context.profileName}`,
+        {
+            type: 'subsection',
+            title: 'configured workers',
+            items: [
+                (context) => context.workers.length > 0
+                    ? context.workers
+                        .map((worker) => `- **${worker.name}**: \`${worker.kind}\``)
+                        .join('\n')
+                    : '- profile に worker は登録されていません',
+            ],
+        },
+    ],
+};
+//# sourceMappingURL=operator-base-module.js.map

package/dist/operator-base-module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-base-module.js","sourceRoot":"","sources":["../src/operator-base-module.ts"],"names":[],"mappings":"AAUA,uFAAuF;AACvF,MAAM,CAAC,MAAM,kBAAkB,GAAwC;IACrE,OAAO,EAAE;QACP,2DAA2D;QAC3D,2DAA2D;KAC5D;IACD,SAAS,EAAE;QACT,mDAAmD;KACpD;IACD,KAAK,EAAE;QACL,2DAA2D;QAC3D,4EAA4E;KAC7E;IACD,WAAW,EAAE;QACX,iFAAiF;QACjF,4DAA4D;KAC7D;IACD,YAAY,EAAE;QACZ,4EAA4E;QAC5E,4DAA4D;QAC5D,8DAA8D;QAC9D,gEAAgE;QAChE;YACE,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,wBAAwB;YAC/B,KAAK,EAAE;gBACL,uDAAuD;gBACvD,4EAA4E;gBAC5E,iCAAiC;aAClC;SACF;KACF;IACD,KAAK,EAAE;QACL,CAAC,OAAO,EAAE,EAAE,CAAC,mBAAmB,OAAO,CAAC,QAAQ,IAAI;QACpD,CAAC,OAAO,EAAE,EAAE,CAAC,0BAA0B,OAAO,CAAC,gBAAgB,IAAI;QACnE,CAAC,OAAO,EAAE,EAAE,CAAC,mBAAmB,OAAO,CAAC,WAAW,EAAE;QACrD;YACE,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,oBAAoB;YAC3B,KAAK,EAAE;gBACL,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;oBACxB,CAAC,CAAC,OAAO,CAAC,OAAO;yBACZ,GAAG,CACF,CAAC,MAAgD,EAAE,EAAE,CACnD,OAAO,MAAM,CAAC,IAAI,SAAS,MAAM,CAAC,IAAI,IAAI,CAC7C;yBACA,IAAI,CAAC,IAAI,CAAC;oBACf,CAAC,CAAC,+BAA+B;aACtC;SACF;KACF;CACF,CAAC"}

package/dist/run-operator-agent.d.ts

@@ -0,0 +1,20 @@
+import { loadEnsembleConfig, loadProfile, type ConductorAgentFactory } from '@agents-ensemble/core/operator-runtime';
+export interface RunOperatorAgentOptions {
+    repoRoot?: string;
+}
+export interface OperatorAgentInput extends NodeJS.ReadableStream {
+    isTTY?: boolean;
+}
+export interface OperatorAgentOutput extends NodeJS.WritableStream {
+    isTTY?: boolean;
+}
+export interface RunOperatorAgentDependencies {
+    stdin?: OperatorAgentInput;
+    stdout?: OperatorAgentOutput;
+    loadConfig?: typeof loadEnsembleConfig;
+    loadProfile?: typeof loadProfile;
+    agentFactory?: ConductorAgentFactory;
+}
+/** Start an operator-role conversation on an interactive terminal. */
+export declare function runOperatorAgent(options?: RunOperatorAgentOptions, dependencies?: RunOperatorAgentDependencies): Promise<void>;
+//# sourceMappingURL=run-operator-agent.d.ts.map

package/dist/run-operator-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-operator-agent.d.ts","sourceRoot":"","sources":["../src/run-operator-agent.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,kBAAkB,EAClB,WAAW,EASX,KAAK,qBAAqB,EAI3B,MAAM,wCAAwC,CAAC;AAIhD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,cAAc;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,mBAAoB,SAAQ,MAAM,CAAC,cAAc;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,kBAAkB,CAAC;IACvC,WAAW,CAAC,EAAE,OAAO,WAAW,CAAC;IACjC,YAAY,CAAC,EAAE,qBAAqB,CAAC;CACtC;AAWD,sEAAsE;AACtE,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,uBAA4B,EACrC,YAAY,GAAE,4BAAiC,GAC9C,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/dist/run-operator-agent.js

@@ -0,0 +1,120 @@
+import { createInterface } from 'node:readline';
+import { resolve } from 'node:path';
+import { compile, merge } from '@modular-prompt/core';
+import { createConductorAgentFactory, filterMaterialsForKind, loadEnsembleConfig, loadProfile, profilePromptModule, renderCompiledPrompt, resolveAgentPromptModule, resolveConductorBackendSetting, resolveConductorModelId, resolveConductorPiResourcePaths, sessionStateFromProfile, } from '@agents-ensemble/core/operator-runtime';
+import { operatorBaseModule } from './operator-base-module.js';
+import { createListOperatorSessionsTool } from './list-operator-sessions-tool.js';
+/** Start an operator-role conversation on an interactive terminal. */
+export async function runOperatorAgent(options = {}, dependencies = {}) {
+    const stdin = dependencies.stdin ?? process.stdin;
+    const stdout = dependencies.stdout ?? process.stdout;
+    assertTty(stdin, stdout);
+    const runtime = await resolveOperatorRuntime(options, dependencies);
+    const factory = dependencies.agentFactory ?? createConductorAgentFactory(runtime.backend);
+    const agent = await factory.create({
+        cwd: runtime.repoRoot,
+        systemPrompt: runtime.systemPrompt,
+        modelId: runtime.modelId,
+        // The operator role has no repository editing or shell tools in Phase 1.
+        builtinTools: false,
+        ...(runtime.backend === 'pi'
+            ? {
+                pi: resolveConductorPiResourcePaths({
+                    repoRoot: runtime.repoRoot,
+                    config: runtime.config,
+                }),
+                piSkills: runtime.profile.conductor?.piSkills !== false,
+                piExtensions: false,
+            }
+            : {}),
+        customTools: {
+            list_operator_sessions: createListOperatorSessionsTool(runtime.repoRoot),
+        },
+    });
+    try {
+        await runTtyConversation({
+            agent,
+            backend: runtime.backend,
+            systemPrompt: runtime.systemPrompt,
+            stdin,
+            stdout,
+        });
+    }
+    finally {
+        await agent.close();
+    }
+}
+async function resolveOperatorRuntime(options, dependencies) {
+    const repoRoot = resolve(options.repoRoot ?? process.cwd());
+    const config = await (dependencies.loadConfig ?? loadEnsembleConfig)(repoRoot);
+    const { profile, profilePath } = await (dependencies.loadProfile ?? loadProfile)({
+        cwd: repoRoot,
+        config,
+    });
+    const backend = resolveConductorBackendSetting({ profile, config });
+    const modelId = resolveConductorModelId(undefined, { config });
+    const sessionState = sessionStateFromProfile(profile);
+    const profileModule = profilePromptModule({
+        agentModule: resolveAgentPromptModule('operator', profile.agents),
+        materials: filterMaterialsForKind(sessionState.materials, 'operator'),
+    });
+    const promptModule = profileModule
+        ? merge(operatorBaseModule, profileModule)
+        : operatorBaseModule;
+    const systemPrompt = renderCompiledPrompt(compile(promptModule, {
+        repoRoot,
+        conductorBackend: backend,
+        profileName: profile.meta?.title ?? profilePath,
+        workers: profile.workers.map(({ name, kind }) => ({ name, kind })),
+    }));
+    return { repoRoot, config, profile, backend, modelId, systemPrompt };
+}
+async function runTtyConversation(options) {
+    const terminal = createInterface({
+        input: options.stdin,
+        output: options.stdout,
+        terminal: true,
+        crlfDelay: Infinity,
+    });
+    const input = terminal[Symbol.asyncIterator]();
+    let firstSend = true;
+    options.stdout.write(`operator-agent (${options.backend}) ready — enter /exit to quit.\n`);
+    try {
+        while (true) {
+            options.stdout.write('user> ');
+            const next = await input.next();
+            if (next.done)
+                return;
+            const message = next.value.trim();
+            if (!message)
+                continue;
+            if (message === '/exit') {
+                options.stdout.write('operator-agent session ended.\n');
+                return;
+            }
+            const prompt = options.backend === 'cursor' && firstSend
+                ? `${options.systemPrompt}\n\n## User message\n\n${message}`
+                : message;
+            const result = await options.agent.send(prompt);
+            firstSend = false;
+            if (result.status === 'error') {
+                options.stdout.write(`operator-agent error: ${result.error?.message ?? result.result ?? 'request failed'}\n`);
+            }
+            else if (result.result?.trim()) {
+                options.stdout.write(`operator> ${result.result.trim()}\n`);
+            }
+            else {
+                options.stdout.write(`operator-agent completed (status: ${result.status}).\n`);
+            }
+        }
+    }
+    finally {
+        terminal.close();
+    }
+}
+function assertTty(stdin, stdout) {
+    if (!stdin.isTTY || !stdout.isTTY) {
+        throw new Error('ensemble operator-agent requires an interactive TTY on stdin and stdout.');
+    }
+}
+//# sourceMappingURL=run-operator-agent.js.map

package/dist/run-operator-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-operator-agent.js","sourceRoot":"","sources":["../src/run-operator-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,8BAA8B,EAC9B,uBAAuB,EACvB,+BAA+B,EAC/B,uBAAuB,GAMxB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AA+BlF,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAmC,EAAE,EACrC,eAA6C,EAAE;IAE/C,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAClD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IACrD,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEzB,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACpE,MAAM,OAAO,GACX,YAAY,CAAC,YAAY,IAAI,2BAA2B,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;QACjC,GAAG,EAAE,OAAO,CAAC,QAAQ;QACrB,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,yEAAyE;QACzE,YAAY,EAAE,KAAK;QACnB,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI;YAC1B,CAAC,CAAC;gBACE,EAAE,EAAE,+BAA+B,CAAC;oBAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;iBACvB,CAAC;gBACF,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,KAAK,KAAK;gBACvD,YAAY,EAAE,KAAK;aACpB;YACH,CAAC,CAAC,EAAE,CAAC;QACP,WAAW,EAAE;YACX,sBAAsB,EAAE,8BAA8B,CAAC,OAAO,CAAC,QAAQ,CAAC;SACzE;KACF,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,kBAAkB,CAAC;YACvB,KAAK;YACL,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,KAAK;YACL,MAAM;SACP,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,OAAgC,EAChC,YAA0C;IAE1C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,UAAU,IAAI,kBAAkB,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC/E,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,WAAW,IAAI,WAAW,CAAC,CAAC;QAC/E,GAAG,EAAE,QAAQ;QACb,MAAM;KACP,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,8BAA8B,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,uBAAuB,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/D,MAAM,YAAY,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,aAAa,GAAG,mBAAmB,CAAC;QACxC,WAAW,EAAE,wBAAwB,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC;QACjE,SAAS,EAAE,sBAAsB,CAAC,YAAY,CAAC,SAAS,EAAE,UAAU,CAAC;KACtE,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,aAAa;QAChC,CAAC,CAAC,KAAK,CAAC,kBAAkB,EAAE,aAAa,CAAC;QAC1C,CAAC,CAAC,kBAAkB,CAAC;IACvB,MAAM,YAAY,GAAG,oBAAoB,CACvC,OAAO,CACL,YAAY,EACZ;QACE,QAAQ;QACR,gBAAgB,EAAE,OAAO;QACzB,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,IAAI,WAAW;QAC/C,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;KACnE,CACF,CACF,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AACvE,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,OAMjC;IACC,MAAM,QAAQ,GAAG,eAAe,CAAC;QAC/B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,QAAQ;KACpB,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;IAC/C,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,mBAAmB,OAAO,CAAC,OAAO,kCAAkC,CACrE,CAAC;IAEF,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC/B,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,IAAI;gBAAE,OAAO;YACtB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;gBACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;gBACxD,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GACV,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,SAAS;gBACvC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,0BAA0B,OAAO,EAAE;gBAC5D,CAAC,CAAC,OAAO,CAAC;YACd,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAChD,SAAS,GAAG,KAAK,CAAC;YAClB,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,yBAAyB,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,MAAM,IAAI,gBAAgB,IAAI,CACxF,CAAC;YACJ,CAAC;iBAAM,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;gBACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC9D,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,MAAM,CAAC,MAAM,MAAM,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAyB,EAAE,MAA2B;IACvE,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,0EAA0E,CAC3E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "@agents-ensemble/operator-agent",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Embedded operator-role agent runtime for agents-ensemble",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@modular-prompt/core": "0.3.0",
+    "@agents-ensemble/core": "0.13.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.18.10",
+    "typescript": "5.9.3",
+    "vitest": "3.2.4"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/otolab/agents-ensemble.git",
+    "directory": "packages/operator-agent"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "test": "vitest",
+    "test:run": "vitest run"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.