@tagma/sdk 0.5.1 → 0.5.2

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.
@@ -1 +1 @@
1
- {"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../src/drivers/opencode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAOb,MAAM,UAAU,CAAC;AAyBlB,eAAO,MAAM,cAAc,EAAE,YA0K5B,CAAC"}
1
+ {"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../src/drivers/opencode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAOb,MAAM,UAAU,CAAC;AAyLlB,eAAO,MAAM,cAAc,EAAE,YAiL5B,CAAC"}
@@ -18,6 +18,138 @@ const EFFORT_TO_VARIANT = {
18
18
  medium: null,
19
19
  high: 'high',
20
20
  };
21
+ let opencodeReady;
22
+ let cachedDefaultModel;
23
+ async function runCapture(args) {
24
+ try {
25
+ const proc = Bun.spawn(args, { stdout: 'pipe', stderr: 'pipe' });
26
+ const [stdout, stderr, code] = await Promise.all([
27
+ new Response(proc.stdout).text(),
28
+ new Response(proc.stderr).text(),
29
+ proc.exited,
30
+ ]);
31
+ return { code, stdout, stderr };
32
+ }
33
+ catch {
34
+ return { code: -1, stdout: '', stderr: '' };
35
+ }
36
+ }
37
+ async function ensureOpencodeInstalled() {
38
+ if (opencodeReady !== undefined)
39
+ return opencodeReady;
40
+ // Probe existing install first — users who already have it get no delay.
41
+ const probe = await runCapture(['opencode', '--version']);
42
+ if (probe.code === 0) {
43
+ opencodeReady = true;
44
+ return true;
45
+ }
46
+ console.error('[driver:opencode] opencode CLI not found — installing via `bun install -g opencode-ai`... (this may take up to a minute)');
47
+ // Use inherit here so the user sees bun's own progress during the one-time
48
+ // install; runCapture would swallow it.
49
+ const install = Bun.spawn(['bun', 'install', '-g', 'opencode-ai'], {
50
+ stdout: 'inherit',
51
+ stderr: 'inherit',
52
+ });
53
+ const installCode = await install.exited;
54
+ if (installCode !== 0) {
55
+ console.error('[driver:opencode] install failed — opencode run will likely fail below.');
56
+ opencodeReady = false;
57
+ return false;
58
+ }
59
+ // Bun installs globals under `~/.bun/bin` (or `%USERPROFILE%\.bun\bin`),
60
+ // which isn't on this process's cached PATH unless the user already has
61
+ // bun set up. Ask bun for the directory and prepend it so bare `opencode`
62
+ // resolves in this process without requiring a shell reload.
63
+ const bin = await runCapture(['bun', 'pm', 'bin', '-g']);
64
+ if (bin.code === 0) {
65
+ const dir = bin.stdout.trim();
66
+ const sep = process.platform === 'win32' ? ';' : ':';
67
+ const current = process.env.PATH ?? '';
68
+ if (dir && !current.split(sep).includes(dir)) {
69
+ process.env.PATH = `${dir}${sep}${current}`;
70
+ }
71
+ }
72
+ const verify = await runCapture(['opencode', '--version']);
73
+ opencodeReady = verify.code === 0;
74
+ if (!opencodeReady) {
75
+ console.error('[driver:opencode] `opencode` still not resolvable after install — check that bun global bin is on PATH.');
76
+ }
77
+ return opencodeReady;
78
+ }
79
+ // `opencode models --verbose` emits "<provider>/<id>\n{...json...}\n" pairs.
80
+ // Walk balanced braces rather than split on newlines so we survive any
81
+ // whitespace oddities in the JSON payload.
82
+ function parseVerboseModels(stdout) {
83
+ const out = [];
84
+ let depth = 0;
85
+ let start = -1;
86
+ for (let i = 0; i < stdout.length; i++) {
87
+ const c = stdout[i];
88
+ if (c === '{') {
89
+ if (depth === 0)
90
+ start = i;
91
+ depth++;
92
+ }
93
+ else if (c === '}') {
94
+ depth--;
95
+ if (depth === 0 && start !== -1) {
96
+ try {
97
+ out.push(JSON.parse(stdout.slice(start, i + 1)));
98
+ }
99
+ catch {
100
+ /* skip malformed block */
101
+ }
102
+ start = -1;
103
+ }
104
+ }
105
+ }
106
+ return out;
107
+ }
108
+ function pickFreeModel(models) {
109
+ const fullId = (m) => `${m.providerID ?? 'opencode'}/${m.id ?? ''}`;
110
+ const eligible = models.filter((m) => {
111
+ if (!m.id || m.id === 'big-pickle')
112
+ return false;
113
+ if (m.status && m.status !== 'active')
114
+ return false;
115
+ const cost = m.cost;
116
+ if (!cost || cost.input !== 0 || cost.output !== 0)
117
+ return false;
118
+ const ctx = m.limit?.context;
119
+ if (typeof ctx !== 'number' || ctx <= 128000)
120
+ return false;
121
+ return true;
122
+ });
123
+ // Prefer models explicitly labelled "-free" by the provider — those are
124
+ // a stronger stability signal than "cost happens to be 0 right now".
125
+ const preferred = eligible.filter((m) => m.id?.endsWith('-free'));
126
+ const pool = preferred.length > 0 ? preferred : eligible;
127
+ if (pool.length === 0)
128
+ return null;
129
+ // Deterministic pick: sort by full id so upstream model-list reordering
130
+ // doesn't flip our choice between runs.
131
+ pool.sort((a, b) => fullId(a).localeCompare(fullId(b)));
132
+ return fullId(pool[0]);
133
+ }
134
+ async function resolveDefaultModel() {
135
+ if (cachedDefaultModel !== undefined)
136
+ return cachedDefaultModel;
137
+ const ready = await ensureOpencodeInstalled();
138
+ if (!ready) {
139
+ cachedDefaultModel = DEFAULT_MODEL;
140
+ return cachedDefaultModel;
141
+ }
142
+ console.error('[driver:opencode] resolving free opencode model...');
143
+ const { code, stdout } = await runCapture(['opencode', 'models', '--verbose']);
144
+ if (code !== 0) {
145
+ cachedDefaultModel = DEFAULT_MODEL;
146
+ return cachedDefaultModel;
147
+ }
148
+ const picked = pickFreeModel(parseVerboseModels(stdout));
149
+ cachedDefaultModel = picked ?? DEFAULT_MODEL;
150
+ console.error(`[driver:opencode] default model: ${cachedDefaultModel}`);
151
+ return cachedDefaultModel;
152
+ }
21
153
  export const OpenCodeDriver = {
22
154
  name: 'opencode',
23
155
  capabilities: {
@@ -29,7 +161,15 @@ export const OpenCodeDriver = {
29
161
  return DEFAULT_MODEL;
30
162
  },
31
163
  async buildCommand(task, track, ctx) {
32
- const model = task.model ?? track.model ?? DEFAULT_MODEL;
164
+ const explicitModel = task.model ?? track.model;
165
+ // Always make sure the opencode CLI is usable before we spawn it — even
166
+ // when the user pinned a model. If missing, ensureOpencodeInstalled
167
+ // auto-installs it via `bun install -g opencode-ai`.
168
+ if (explicitModel)
169
+ await ensureOpencodeInstalled();
170
+ // Otherwise resolveDefaultModel both ensures the CLI and picks a free
171
+ // model from `opencode models --verbose` (cached per-process).
172
+ const model = explicitModel ?? (await resolveDefaultModel());
33
173
  // Resolve reasoning_effort → opencode --variant. SDK schema layer already
34
174
  // resolved task → track → pipeline inheritance, so we only need to read
35
175
  // task.reasoning_effort here.
@@ -1 +1 @@
1
- {"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../src/drivers/opencode.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../src/drivers/opencode.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tagma/sdk",
3
- "version": "0.5.1",
3
+ "version": "0.5.2",
4
4
  "description": "Local AI task orchestration engine — core SDK for tagma pipelines",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -31,6 +31,166 @@ const EFFORT_TO_VARIANT: Record<string, string | null> = {
31
31
  high: 'high',
32
32
  };
33
33
 
34
+ // ── Auto-install + free-model picker ───────────────────────────────────────
35
+ //
36
+ // The opencode driver is SDK-built-in, but the `opencode` CLI isn't; we
37
+ // auto-install it on demand (via `bun install -g opencode-ai`) and pick a
38
+ // sensible default model from whatever the CLI reports. Both checks are
39
+ // process-cached via module-level variables so each concern runs at most
40
+ // once per SDK process.
41
+ //
42
+ // Design:
43
+ // - User-provided `model:` wins; we only compute a default when it's empty.
44
+ // - Failure modes never throw — they fall back to `DEFAULT_MODEL` and let
45
+ // the subsequent `opencode run` spawn fail with its own error. Avoids
46
+ // two confusing errors for one missing dependency.
47
+
48
+ interface OpencodeModelInfo {
49
+ id?: string;
50
+ providerID?: string;
51
+ status?: string;
52
+ cost?: { input?: number; output?: number };
53
+ limit?: { context?: number };
54
+ }
55
+
56
+ let opencodeReady: boolean | undefined;
57
+ let cachedDefaultModel: string | undefined;
58
+
59
+ async function runCapture(
60
+ args: string[],
61
+ ): Promise<{ code: number; stdout: string; stderr: string }> {
62
+ try {
63
+ const proc = Bun.spawn(args, { stdout: 'pipe', stderr: 'pipe' });
64
+ const [stdout, stderr, code] = await Promise.all([
65
+ new Response(proc.stdout).text(),
66
+ new Response(proc.stderr).text(),
67
+ proc.exited,
68
+ ]);
69
+ return { code, stdout, stderr };
70
+ } catch {
71
+ return { code: -1, stdout: '', stderr: '' };
72
+ }
73
+ }
74
+
75
+ async function ensureOpencodeInstalled(): Promise<boolean> {
76
+ if (opencodeReady !== undefined) return opencodeReady;
77
+
78
+ // Probe existing install first — users who already have it get no delay.
79
+ const probe = await runCapture(['opencode', '--version']);
80
+ if (probe.code === 0) {
81
+ opencodeReady = true;
82
+ return true;
83
+ }
84
+
85
+ console.error(
86
+ '[driver:opencode] opencode CLI not found — installing via `bun install -g opencode-ai`... (this may take up to a minute)',
87
+ );
88
+ // Use inherit here so the user sees bun's own progress during the one-time
89
+ // install; runCapture would swallow it.
90
+ const install = Bun.spawn(['bun', 'install', '-g', 'opencode-ai'], {
91
+ stdout: 'inherit',
92
+ stderr: 'inherit',
93
+ });
94
+ const installCode = await install.exited;
95
+ if (installCode !== 0) {
96
+ console.error('[driver:opencode] install failed — opencode run will likely fail below.');
97
+ opencodeReady = false;
98
+ return false;
99
+ }
100
+
101
+ // Bun installs globals under `~/.bun/bin` (or `%USERPROFILE%\.bun\bin`),
102
+ // which isn't on this process's cached PATH unless the user already has
103
+ // bun set up. Ask bun for the directory and prepend it so bare `opencode`
104
+ // resolves in this process without requiring a shell reload.
105
+ const bin = await runCapture(['bun', 'pm', 'bin', '-g']);
106
+ if (bin.code === 0) {
107
+ const dir = bin.stdout.trim();
108
+ const sep = process.platform === 'win32' ? ';' : ':';
109
+ const current = process.env.PATH ?? '';
110
+ if (dir && !current.split(sep).includes(dir)) {
111
+ process.env.PATH = `${dir}${sep}${current}`;
112
+ }
113
+ }
114
+
115
+ const verify = await runCapture(['opencode', '--version']);
116
+ opencodeReady = verify.code === 0;
117
+ if (!opencodeReady) {
118
+ console.error(
119
+ '[driver:opencode] `opencode` still not resolvable after install — check that bun global bin is on PATH.',
120
+ );
121
+ }
122
+ return opencodeReady;
123
+ }
124
+
125
+ // `opencode models --verbose` emits "<provider>/<id>\n{...json...}\n" pairs.
126
+ // Walk balanced braces rather than split on newlines so we survive any
127
+ // whitespace oddities in the JSON payload.
128
+ function parseVerboseModels(stdout: string): OpencodeModelInfo[] {
129
+ const out: OpencodeModelInfo[] = [];
130
+ let depth = 0;
131
+ let start = -1;
132
+ for (let i = 0; i < stdout.length; i++) {
133
+ const c = stdout[i];
134
+ if (c === '{') {
135
+ if (depth === 0) start = i;
136
+ depth++;
137
+ } else if (c === '}') {
138
+ depth--;
139
+ if (depth === 0 && start !== -1) {
140
+ try {
141
+ out.push(JSON.parse(stdout.slice(start, i + 1)) as OpencodeModelInfo);
142
+ } catch {
143
+ /* skip malformed block */
144
+ }
145
+ start = -1;
146
+ }
147
+ }
148
+ }
149
+ return out;
150
+ }
151
+
152
+ function pickFreeModel(models: OpencodeModelInfo[]): string | null {
153
+ const fullId = (m: OpencodeModelInfo): string =>
154
+ `${m.providerID ?? 'opencode'}/${m.id ?? ''}`;
155
+ const eligible = models.filter((m) => {
156
+ if (!m.id || m.id === 'big-pickle') return false;
157
+ if (m.status && m.status !== 'active') return false;
158
+ const cost = m.cost;
159
+ if (!cost || cost.input !== 0 || cost.output !== 0) return false;
160
+ const ctx = m.limit?.context;
161
+ if (typeof ctx !== 'number' || ctx <= 128000) return false;
162
+ return true;
163
+ });
164
+ // Prefer models explicitly labelled "-free" by the provider — those are
165
+ // a stronger stability signal than "cost happens to be 0 right now".
166
+ const preferred = eligible.filter((m) => m.id?.endsWith('-free'));
167
+ const pool = preferred.length > 0 ? preferred : eligible;
168
+ if (pool.length === 0) return null;
169
+ // Deterministic pick: sort by full id so upstream model-list reordering
170
+ // doesn't flip our choice between runs.
171
+ pool.sort((a, b) => fullId(a).localeCompare(fullId(b)));
172
+ return fullId(pool[0]);
173
+ }
174
+
175
+ async function resolveDefaultModel(): Promise<string> {
176
+ if (cachedDefaultModel !== undefined) return cachedDefaultModel;
177
+ const ready = await ensureOpencodeInstalled();
178
+ if (!ready) {
179
+ cachedDefaultModel = DEFAULT_MODEL;
180
+ return cachedDefaultModel;
181
+ }
182
+ console.error('[driver:opencode] resolving free opencode model...');
183
+ const { code, stdout } = await runCapture(['opencode', 'models', '--verbose']);
184
+ if (code !== 0) {
185
+ cachedDefaultModel = DEFAULT_MODEL;
186
+ return cachedDefaultModel;
187
+ }
188
+ const picked = pickFreeModel(parseVerboseModels(stdout));
189
+ cachedDefaultModel = picked ?? DEFAULT_MODEL;
190
+ console.error(`[driver:opencode] default model: ${cachedDefaultModel}`);
191
+ return cachedDefaultModel;
192
+ }
193
+
34
194
  export const OpenCodeDriver: DriverPlugin = {
35
195
  name: 'opencode',
36
196
 
@@ -45,7 +205,14 @@ export const OpenCodeDriver: DriverPlugin = {
45
205
  },
46
206
 
47
207
  async buildCommand(task: TaskConfig, track: TrackConfig, ctx: DriverContext): Promise<SpawnSpec> {
48
- const model = task.model ?? track.model ?? DEFAULT_MODEL;
208
+ const explicitModel = task.model ?? track.model;
209
+ // Always make sure the opencode CLI is usable before we spawn it — even
210
+ // when the user pinned a model. If missing, ensureOpencodeInstalled
211
+ // auto-installs it via `bun install -g opencode-ai`.
212
+ if (explicitModel) await ensureOpencodeInstalled();
213
+ // Otherwise resolveDefaultModel both ensures the CLI and picks a free
214
+ // model from `opencode models --verbose` (cached per-process).
215
+ const model = explicitModel ?? (await resolveDefaultModel());
49
216
  // Resolve reasoning_effort → opencode --variant. SDK schema layer already
50
217
  // resolved task → track → pipeline inheritance, so we only need to read
51
218
  // task.reasoning_effort here.