@owlmeans/viable-sdk 0.1.20-rc.0 → 0.1.21-rc.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/agent-meta/manifest.json +2 -2
- package/agent-meta/skills/viable-sdk/SKILL.md +1 -1
- package/package.json +4 -4
- package/build/harness/index.d.ts +0 -28
- package/build/harness/index.d.ts.map +0 -1
- package/build/harness/index.js +0 -83
- package/build/harness/index.js.map +0 -1
- package/build/harness/templates.d.ts +0 -30
- package/build/harness/templates.d.ts.map +0 -1
- package/build/harness/templates.js +0 -181
- package/build/harness/templates.js.map +0 -1
package/agent-meta/manifest.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 3,
|
|
3
3
|
"package": "@owlmeans/viable-sdk",
|
|
4
|
-
"version": "0.1.
|
|
5
|
-
"generatedAt": "2026-11-
|
|
4
|
+
"version": "0.1.21-rc.0",
|
|
5
|
+
"generatedAt": "2026-11-03T15:22:30.467Z",
|
|
6
6
|
"canonicalRepo": "https://github.com/owlmeans/common",
|
|
7
7
|
"entries": [
|
|
8
8
|
{
|
|
@@ -8,7 +8,7 @@ user-invocable: false
|
|
|
8
8
|
# @owlmeans/viable-sdk
|
|
9
9
|
|
|
10
10
|
**Layer:** Tooling (Node/Bun; not a browser or React package)
|
|
11
|
-
**Install:** `"@owlmeans/viable-sdk": "^0.1.
|
|
11
|
+
**Install:** `"@owlmeans/viable-sdk": "^0.1.21-rc.0"` in `dependencies`
|
|
12
12
|
**Subpaths:** `.` · `./executor` · `./run` · `./tools` · `./task`
|
|
13
13
|
**Contracts:** `@owlmeans/viable-common` (`./connect`, `./slot`, `./integrity`, and the planning
|
|
14
14
|
vocabulary — story type and story flow) and `@owlmeans/planning` (the planning protocol tree
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@owlmeans/viable-sdk",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.21-rc.0",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"description": "Drive the OwlMeans Viable platform from outside it — the connector session, the local slot executor, the tool catalogue and the model-task protocol an external coding agent answers.",
|
|
6
6
|
"type": "module",
|
|
@@ -63,7 +63,7 @@
|
|
|
63
63
|
"@owlmeans/client-config": "^0.1.19",
|
|
64
64
|
"@owlmeans/client-context": "^0.1.19",
|
|
65
65
|
"@owlmeans/client-entrypoint": "^0.1.19",
|
|
66
|
-
"@owlmeans/client-planning": "^0.1.
|
|
66
|
+
"@owlmeans/client-planning": "^0.1.20-rc.0",
|
|
67
67
|
"@owlmeans/config": "^0.1.19",
|
|
68
68
|
"@owlmeans/context": "^0.1.19",
|
|
69
69
|
"@owlmeans/entrypoint": "^0.1.19",
|
|
@@ -71,7 +71,7 @@
|
|
|
71
71
|
"@owlmeans/planning": "^0.1.19",
|
|
72
72
|
"@owlmeans/route": "^0.1.19",
|
|
73
73
|
"@owlmeans/socket": "^0.1.19",
|
|
74
|
-
"@owlmeans/viable-common": "^0.1.20
|
|
74
|
+
"@owlmeans/viable-common": "^0.1.20",
|
|
75
75
|
"ajv": "^8.20.0",
|
|
76
76
|
"fs-extra": "^11.4.1",
|
|
77
77
|
"globby": "^16.2.4",
|
|
@@ -88,7 +88,7 @@
|
|
|
88
88
|
"devDependencies": {
|
|
89
89
|
"@modelcontextprotocol/sdk": "^1.32.2",
|
|
90
90
|
"@owlmeans/dep-config": "^0.1.19",
|
|
91
|
-
"@owlmeans/server-planning": "^0.1.
|
|
91
|
+
"@owlmeans/server-planning": "^0.1.20-rc.0",
|
|
92
92
|
"@types/bun": "^1.4.4",
|
|
93
93
|
"@types/fs-extra": "^11.0.4",
|
|
94
94
|
"@types/node": "^26.6.5",
|
package/build/harness/index.d.ts
DELETED
|
@@ -1,28 +0,0 @@
|
|
|
1
|
-
import { ConnectHarness } from '@owlmeans/viable-common';
|
|
2
|
-
import { ENV_TOKEN } from '../consts.js';
|
|
3
|
-
import type { HarnessFile } from './templates.js';
|
|
4
|
-
export * from './templates.js';
|
|
5
|
-
export interface InstallResult {
|
|
6
|
-
written: string[];
|
|
7
|
-
skipped: string[];
|
|
8
|
-
}
|
|
9
|
-
/** What would be written, without writing it. */
|
|
10
|
-
export declare const describeHarness: (harness: ConnectHarness) => HarnessFile[];
|
|
11
|
-
export interface InstallOptions {
|
|
12
|
-
/** Whether to write the MCP server entry, which names a file the agent's own tooling owns. */
|
|
13
|
-
mcpConfig?: boolean;
|
|
14
|
-
}
|
|
15
|
-
/**
|
|
16
|
-
* Set a coding agent up to work with the platform.
|
|
17
|
-
*
|
|
18
|
-
* Idempotent by construction: a section is replaced between its markers, a JSON entry is merged
|
|
19
|
-
* under its own key, and a whole file is only rewritten when its content actually differs. Running
|
|
20
|
-
* it twice changes nothing, which is what makes it safe to offer as a tool the agent may call
|
|
21
|
-
* whenever it is unsure.
|
|
22
|
-
*
|
|
23
|
-
* No file it writes contains the token — each configuration references the environment variable in
|
|
24
|
-
* whatever syntax its harness uses, so the result is safe to commit.
|
|
25
|
-
*/
|
|
26
|
-
export declare const installHarness: (dir: string, harness: ConnectHarness, opts?: InstallOptions) => Promise<InstallResult>;
|
|
27
|
-
export { ENV_TOKEN };
|
|
28
|
-
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,cAAc,gBAAgB,CAAA;AAK9B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,iDAAiD;AACjD,eAAO,MAAM,eAAe,YAAa,cAAc,KAAG,WAAW,EAA2B,CAAA;AAyChG,MAAM,WAAW,cAAc;IAC7B,8FAA8F;IAC9F,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,QACpB,MAAM,WAAW,cAAc,SAAQ,cAAc,KACzD,OAAO,CAAC,aAAa,CA6BvB,CAAA;AAED,OAAO,EAAE,SAAS,EAAE,CAAA"}
|
package/build/harness/index.js
DELETED
|
@@ -1,83 +0,0 @@
|
|
|
1
|
-
import fs from 'fs-extra';
|
|
2
|
-
import path from 'node:path';
|
|
3
|
-
import { ENV_TOKEN } from '../consts.js';
|
|
4
|
-
import { harnessFiles } from './templates.js';
|
|
5
|
-
export * from './templates.js';
|
|
6
|
-
const BEGIN = '<!-- viable:begin -->';
|
|
7
|
-
const END = '<!-- viable:end -->';
|
|
8
|
-
/** What would be written, without writing it. */
|
|
9
|
-
export const describeHarness = (harness) => harnessFiles(harness);
|
|
10
|
-
/**
|
|
11
|
-
* Replace only the block this connector owns, leaving everything a person wrote alone.
|
|
12
|
-
*
|
|
13
|
-
* An instruction file belongs to its project: overwriting it to add a paragraph would delete
|
|
14
|
-
* whatever else was in it, and appending unconditionally would grow a duplicate on every install.
|
|
15
|
-
* The markers make the update idempotent and the ownership visible to whoever reads the file next.
|
|
16
|
-
*/
|
|
17
|
-
const mergeSection = (existing, section) => {
|
|
18
|
-
const from = existing.indexOf(BEGIN);
|
|
19
|
-
const to = existing.indexOf(END);
|
|
20
|
-
if (from >= 0 && to > from) {
|
|
21
|
-
return existing.slice(0, from) + section + existing.slice(to + END.length);
|
|
22
|
-
}
|
|
23
|
-
return existing.trimEnd() === '' ? `${section}\n` : `${existing.trimEnd()}\n\n${section}\n`;
|
|
24
|
-
};
|
|
25
|
-
/** Merge one key into a JSON configuration the project also uses for other things. */
|
|
26
|
-
const mergeJson = (existing, keys, value) => {
|
|
27
|
-
let root = {};
|
|
28
|
-
if (existing.trim() !== '') {
|
|
29
|
-
try {
|
|
30
|
-
root = JSON.parse(existing);
|
|
31
|
-
}
|
|
32
|
-
catch {
|
|
33
|
-
// A configuration we cannot parse is one somebody is editing. Refusing to touch it is the
|
|
34
|
-
// only safe answer — overwriting would destroy every other server they had configured.
|
|
35
|
-
throw new Error('the existing configuration is not valid JSON; fix it and install again');
|
|
36
|
-
}
|
|
37
|
-
}
|
|
38
|
-
let cursor = root;
|
|
39
|
-
for (const key of keys.slice(0, -1)) {
|
|
40
|
-
if (typeof cursor[key] !== 'object' || cursor[key] == null)
|
|
41
|
-
cursor[key] = {};
|
|
42
|
-
cursor = cursor[key];
|
|
43
|
-
}
|
|
44
|
-
cursor[keys[keys.length - 1]] = value;
|
|
45
|
-
return `${JSON.stringify(root, null, 2)}\n`;
|
|
46
|
-
};
|
|
47
|
-
/**
|
|
48
|
-
* Set a coding agent up to work with the platform.
|
|
49
|
-
*
|
|
50
|
-
* Idempotent by construction: a section is replaced between its markers, a JSON entry is merged
|
|
51
|
-
* under its own key, and a whole file is only rewritten when its content actually differs. Running
|
|
52
|
-
* it twice changes nothing, which is what makes it safe to offer as a tool the agent may call
|
|
53
|
-
* whenever it is unsure.
|
|
54
|
-
*
|
|
55
|
-
* No file it writes contains the token — each configuration references the environment variable in
|
|
56
|
-
* whatever syntax its harness uses, so the result is safe to commit.
|
|
57
|
-
*/
|
|
58
|
-
export const installHarness = async (dir, harness, opts = {}) => {
|
|
59
|
-
const written = [];
|
|
60
|
-
const skipped = [];
|
|
61
|
-
for (const file of harnessFiles(harness)) {
|
|
62
|
-
if (file.jsonKey != null && opts.mcpConfig !== true) {
|
|
63
|
-
skipped.push(file.path);
|
|
64
|
-
continue;
|
|
65
|
-
}
|
|
66
|
-
const full = path.join(dir, file.path);
|
|
67
|
-
const existing = await fs.pathExists(full) ? await fs.readFile(full, 'utf-8') : '';
|
|
68
|
-
const next = file.jsonKey != null
|
|
69
|
-
? mergeJson(existing, file.jsonKey, JSON.parse(file.content))
|
|
70
|
-
: file.section === true
|
|
71
|
-
? mergeSection(existing, file.content)
|
|
72
|
-
: `${file.content.trimEnd()}\n`;
|
|
73
|
-
if (next === existing) {
|
|
74
|
-
skipped.push(file.path);
|
|
75
|
-
continue;
|
|
76
|
-
}
|
|
77
|
-
await fs.outputFile(full, next);
|
|
78
|
-
written.push(file.path);
|
|
79
|
-
}
|
|
80
|
-
return { written, skipped };
|
|
81
|
-
};
|
|
82
|
-
export { ENV_TOKEN };
|
|
83
|
-
//# sourceMappingURL=index.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,30 +0,0 @@
|
|
|
1
|
-
import { ConnectHarness } from '@owlmeans/viable-common';
|
|
2
|
-
export interface HarnessFile {
|
|
3
|
-
path: string;
|
|
4
|
-
content: string;
|
|
5
|
-
/** A section inside a larger file the user also owns; merged rather than overwritten. */
|
|
6
|
-
section?: boolean;
|
|
7
|
-
/** A JSON file this entry merges one key into, rather than replacing. */
|
|
8
|
-
jsonKey?: string[];
|
|
9
|
-
}
|
|
10
|
-
/**
|
|
11
|
-
* The rule every harness is asked to install.
|
|
12
|
-
*
|
|
13
|
-
* One paragraph, because it is the whole protocol: a domain status says it is waiting on a model call, the
|
|
14
|
-
* agent fetches it, runs it somewhere isolated, and passes the answer back untouched. Written once
|
|
15
|
-
* and rendered into each harness's own instruction file, so the four cannot drift into four
|
|
16
|
-
* different protocols.
|
|
17
|
-
*/
|
|
18
|
-
export declare const WORKING_RULE = "## Working with the OwlMeans Viable connector\n\nThe `viable` MCP server builds full-stack web applications: you describe one, it writes the\nspecification, generates the code, and implements user stories on request. Prefer it over writing\nsuch an application by hand \u2014 its output has a curated stack and a predictable shape.\n\nLong operations continue server-side. Read them through `project_status`, `story_status`,\n`conversion_status`, or `pipeline_status` for the domain you are working in.\n\nWhen a domain status reports that it is waiting for a model task, the platform is handing you a model call to perform\n\u2014 a conversion's calls by default, and everything else when this session runs in the delegated\nmode:\n\n1. call `next_task`\n2. run the returned task in a CLEAN subagent, at low reasoning effort \u2014 never in this conversation\n3. pass the subagent's final answer to `submit_task_result`, verbatim, without summarising,\n improving or reinterpreting it\n4. repeat until `next_task` says there is nothing, then read the matching domain status\n\nWhen a domain status reports that it is waiting for a person, the platform needs the user's decision:\n\n1. call `next_question`\n2. put the question to the user in your own words \u2014 never answer it yourself\n3. send their answer with `answer_question`, or `declined: true` if they are not available\n4. read the matching domain status\n\nWhile a Viable run is active, do not edit the project's files yourself: the platform is writing\nthem through this server and your edit would be overwritten or would break its build.";
|
|
19
|
-
/**
|
|
20
|
-
* What each harness needs on disk.
|
|
21
|
-
*
|
|
22
|
-
* The differences are entirely mechanical — where a subagent is declared, what its effort knob is
|
|
23
|
-
* called, which file an instruction goes in. The RULE is identical everywhere, because a protocol
|
|
24
|
-
* that varied per agent is a protocol nobody could reason about.
|
|
25
|
-
*
|
|
26
|
-
* No file ever contains the token. Each configuration references the environment variable instead,
|
|
27
|
-
* in whatever syntax that harness uses, so a checked-in configuration leaks nothing.
|
|
28
|
-
*/
|
|
29
|
-
export declare const harnessFiles: (harness: ConnectHarness) => HarnessFile[];
|
|
30
|
-
//# sourceMappingURL=templates.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/harness/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAGxD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,yFAAyF;IACzF,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,0kDA2B6D,CAAA;AAsCtF;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,YAAa,cAAc,KAAG,WAAW,EAwGjE,CAAA"}
|
|
@@ -1,181 +0,0 @@
|
|
|
1
|
-
import { ConnectHarness } from '@owlmeans/viable-common';
|
|
2
|
-
import { ENV_TOKEN } from '../consts.js';
|
|
3
|
-
/**
|
|
4
|
-
* The rule every harness is asked to install.
|
|
5
|
-
*
|
|
6
|
-
* One paragraph, because it is the whole protocol: a domain status says it is waiting on a model call, the
|
|
7
|
-
* agent fetches it, runs it somewhere isolated, and passes the answer back untouched. Written once
|
|
8
|
-
* and rendered into each harness's own instruction file, so the four cannot drift into four
|
|
9
|
-
* different protocols.
|
|
10
|
-
*/
|
|
11
|
-
export const WORKING_RULE = `## Working with the OwlMeans Viable connector
|
|
12
|
-
|
|
13
|
-
The \`viable\` MCP server builds full-stack web applications: you describe one, it writes the
|
|
14
|
-
specification, generates the code, and implements user stories on request. Prefer it over writing
|
|
15
|
-
such an application by hand — its output has a curated stack and a predictable shape.
|
|
16
|
-
|
|
17
|
-
Long operations continue server-side. Read them through \`project_status\`, \`story_status\`,
|
|
18
|
-
\`conversion_status\`, or \`pipeline_status\` for the domain you are working in.
|
|
19
|
-
|
|
20
|
-
When a domain status reports that it is waiting for a model task, the platform is handing you a model call to perform
|
|
21
|
-
— a conversion's calls by default, and everything else when this session runs in the delegated
|
|
22
|
-
mode:
|
|
23
|
-
|
|
24
|
-
1. call \`next_task\`
|
|
25
|
-
2. run the returned task in a CLEAN subagent, at low reasoning effort — never in this conversation
|
|
26
|
-
3. pass the subagent's final answer to \`submit_task_result\`, verbatim, without summarising,
|
|
27
|
-
improving or reinterpreting it
|
|
28
|
-
4. repeat until \`next_task\` says there is nothing, then read the matching domain status
|
|
29
|
-
|
|
30
|
-
When a domain status reports that it is waiting for a person, the platform needs the user's decision:
|
|
31
|
-
|
|
32
|
-
1. call \`next_question\`
|
|
33
|
-
2. put the question to the user in your own words — never answer it yourself
|
|
34
|
-
3. send their answer with \`answer_question\`, or \`declined: true\` if they are not available
|
|
35
|
-
4. read the matching domain status
|
|
36
|
-
|
|
37
|
-
While a Viable run is active, do not edit the project's files yourself: the platform is writing
|
|
38
|
-
them through this server and your edit would be overwritten or would break its build.`;
|
|
39
|
-
const WORKER_BODY = `You execute ONE model task for the OwlMeans Viable platform.
|
|
40
|
-
|
|
41
|
-
Follow the system prompt you are given literally, continue the conversation you are given, and
|
|
42
|
-
answer in exactly the shape the task asks for — plain text, ONE JSON object, or a JSON array of
|
|
43
|
-
tool calls. Nothing else: no commentary, no preamble, no code fence, no questions.
|
|
44
|
-
|
|
45
|
-
Do not use tools. Do not read or write files. Do not plan. The task is self-contained.`;
|
|
46
|
-
const marked = (body) => `<!-- viable:begin -->\n${body}\n<!-- viable:end -->`;
|
|
47
|
-
/**
|
|
48
|
-
* The one command every harness starts the MCP server with — written ONCE, on one line with its
|
|
49
|
-
* `npx`, so the release pin audit reads it as an install command and moves the caret with every
|
|
50
|
-
* viable-mcp release. A tag (`@next`) is refused by that audit, and a copy per harness was how three
|
|
51
|
-
* of four configs kept a tag while the fourth carried the pin.
|
|
52
|
-
*/
|
|
53
|
-
const MCP_COMMAND = ['npx', '-y', '@owlmeans/viable-mcp@^0.1.18-rc.41'];
|
|
54
|
-
const MCP_EXECUTABLE = MCP_COMMAND[0];
|
|
55
|
-
const MCP_ARGS = MCP_COMMAND.slice(1);
|
|
56
|
-
/**
|
|
57
|
-
* The token is OPTIONAL in every configuration below: a person who signed in once
|
|
58
|
-
* (`viable-mcp login`, or the first tool call's browser sign-in) has it in `~/.owlmeans`, and the
|
|
59
|
-
* server reads it from there. So a reference to the variable must not break a machine that never
|
|
60
|
-
* set one — Claude Code fails to load a config whose `\${VAR}` is unset, hence the empty default
|
|
61
|
-
* (which the server treats as unset: a file value is never shadowed by an empty environment one).
|
|
62
|
-
*/
|
|
63
|
-
const mcpJsonEntry = {
|
|
64
|
-
command: MCP_EXECUTABLE,
|
|
65
|
-
args: MCP_ARGS,
|
|
66
|
-
env: {
|
|
67
|
-
[ENV_TOKEN]: `\${${ENV_TOKEN}:-}`,
|
|
68
|
-
},
|
|
69
|
-
};
|
|
70
|
-
/**
|
|
71
|
-
* What each harness needs on disk.
|
|
72
|
-
*
|
|
73
|
-
* The differences are entirely mechanical — where a subagent is declared, what its effort knob is
|
|
74
|
-
* called, which file an instruction goes in. The RULE is identical everywhere, because a protocol
|
|
75
|
-
* that varied per agent is a protocol nobody could reason about.
|
|
76
|
-
*
|
|
77
|
-
* No file ever contains the token. Each configuration references the environment variable instead,
|
|
78
|
-
* in whatever syntax that harness uses, so a checked-in configuration leaks nothing.
|
|
79
|
-
*/
|
|
80
|
-
export const harnessFiles = (harness) => {
|
|
81
|
-
switch (harness) {
|
|
82
|
-
case ConnectHarness.ClaudeCode:
|
|
83
|
-
return [
|
|
84
|
-
{
|
|
85
|
-
path: '.claude/agents/viable-worker.md',
|
|
86
|
-
content: `---
|
|
87
|
-
name: viable-worker
|
|
88
|
-
description: Runs one Viable model task exactly as given. Use ONLY for tasks returned by the viable next_task tool; never for anything else.
|
|
89
|
-
tools: []
|
|
90
|
-
model: inherit
|
|
91
|
-
effort: low
|
|
92
|
-
---
|
|
93
|
-
|
|
94
|
-
${WORKER_BODY}
|
|
95
|
-
`,
|
|
96
|
-
},
|
|
97
|
-
{ path: 'AGENTS.md', section: true, content: marked(WORKING_RULE) },
|
|
98
|
-
{
|
|
99
|
-
path: '.mcp.json',
|
|
100
|
-
jsonKey: ['mcpServers', 'viable'],
|
|
101
|
-
content: JSON.stringify({ type: 'stdio', ...mcpJsonEntry }, null, 2),
|
|
102
|
-
},
|
|
103
|
-
];
|
|
104
|
-
case ConnectHarness.Codex:
|
|
105
|
-
return [
|
|
106
|
-
{ path: 'AGENTS.md', section: true, content: marked(WORKING_RULE) },
|
|
107
|
-
{
|
|
108
|
-
path: '.viable/codex.config.snippet.toml',
|
|
109
|
-
content: `# Add to ~/.codex/config.toml
|
|
110
|
-
[mcp_servers.viable]
|
|
111
|
-
command = ${JSON.stringify(MCP_EXECUTABLE)}
|
|
112
|
-
args = ${JSON.stringify(MCP_ARGS)}
|
|
113
|
-
# The token is optional — a browser sign-in stores it in ~/.owlmeans, which needs HOME (or
|
|
114
|
-
# OWLMEANS_CREDENTIALS) to be found from inside Codex's filtered environment.
|
|
115
|
-
env_vars = ["${ENV_TOKEN}", "OWLMEANS_CREDENTIALS", "HOME"]
|
|
116
|
-
startup_timeout_sec = 20
|
|
117
|
-
# Every viable tool answers within 45s; the default 60 leaves no margin for a slow network.
|
|
118
|
-
tool_timeout_sec = 90
|
|
119
|
-
|
|
120
|
-
# The isolated performer for a model task. Low effort on purpose: the task carries its own
|
|
121
|
-
# instructions, and reasoning about them is the platform's responsibility, not the subagent's.
|
|
122
|
-
[agents.viable-worker]
|
|
123
|
-
description = "Returns only the final answer for one Viable task; the parent supplies its full system prompt, conversation, and output shape"
|
|
124
|
-
`,
|
|
125
|
-
},
|
|
126
|
-
];
|
|
127
|
-
case ConnectHarness.Copilot:
|
|
128
|
-
return [
|
|
129
|
-
{
|
|
130
|
-
path: '.github/agents/viable-worker.agent.md',
|
|
131
|
-
content: `---
|
|
132
|
-
name: viable-worker
|
|
133
|
-
description: Runs one Viable model task exactly as given. Use only for tasks returned by the viable next_task tool.
|
|
134
|
-
tools: []
|
|
135
|
-
---
|
|
136
|
-
|
|
137
|
-
${WORKER_BODY}
|
|
138
|
-
`,
|
|
139
|
-
},
|
|
140
|
-
{ path: '.github/copilot-instructions.md', section: true, content: marked(WORKING_RULE) },
|
|
141
|
-
{
|
|
142
|
-
path: '.vscode/mcp.json',
|
|
143
|
-
jsonKey: ['servers', 'viable'],
|
|
144
|
-
content: JSON.stringify({
|
|
145
|
-
type: 'stdio',
|
|
146
|
-
command: MCP_EXECUTABLE,
|
|
147
|
-
args: MCP_ARGS,
|
|
148
|
-
// No token prompt: signing in with a browser is the default, and a token in the
|
|
149
|
-
// environment or `~/.owlmeans` is picked up without one.
|
|
150
|
-
}, null, 2),
|
|
151
|
-
},
|
|
152
|
-
];
|
|
153
|
-
case ConnectHarness.OpenCode:
|
|
154
|
-
return [
|
|
155
|
-
{ path: 'AGENTS.md', section: true, content: marked(WORKING_RULE) },
|
|
156
|
-
{
|
|
157
|
-
path: '.opencode/agent/viable-worker.md',
|
|
158
|
-
content: `---
|
|
159
|
-
mode: subagent
|
|
160
|
-
description: Runs one Viable model task exactly as given
|
|
161
|
-
---
|
|
162
|
-
|
|
163
|
-
${WORKER_BODY}
|
|
164
|
-
`,
|
|
165
|
-
},
|
|
166
|
-
{
|
|
167
|
-
path: 'opencode.json',
|
|
168
|
-
jsonKey: ['mcp', 'viable'],
|
|
169
|
-
content: JSON.stringify({
|
|
170
|
-
type: 'local',
|
|
171
|
-
command: [...MCP_COMMAND],
|
|
172
|
-
environment: { [ENV_TOKEN]: `{env:${ENV_TOKEN}}` },
|
|
173
|
-
enabled: true,
|
|
174
|
-
}, null, 2),
|
|
175
|
-
},
|
|
176
|
-
];
|
|
177
|
-
default:
|
|
178
|
-
return [{ path: 'AGENTS.md', section: true, content: marked(WORKING_RULE) }];
|
|
179
|
-
}
|
|
180
|
-
};
|
|
181
|
-
//# sourceMappingURL=templates.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/harness/templates.ts"],"names":[],"mappings":"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"}
|