oda-engine 0.0.0-stage → 0.1.1
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/README.md +151 -2
- package/bin/nowhere.mjs +352 -0
- package/lib/account.mjs +57 -0
- package/lib/agentModules.mjs +57 -0
- package/lib/devServer.mjs +351 -0
- package/lib/headless.mjs +231 -0
- package/lib/headlessPreview.mjs +212 -0
- package/lib/keys.mjs +517 -0
- package/lib/make.mjs +855 -0
- package/lib/mcp.mjs +537 -0
- package/lib/open.mjs +22 -0
- package/lib/preview.mjs +87 -0
- package/lib/previewRpc.mjs +134 -0
- package/lib/project.mjs +359 -0
- package/lib/publishFlow.mjs +131 -0
- package/lib/resources.mjs +50 -0
- package/lib/rules.mjs +60 -0
- package/lib/scaffold.mjs +42 -0
- package/lib/setup.mjs +59 -0
- package/lib/tools.mjs +668 -0
- package/package.json +51 -4
- package/template/game.config.json +9 -0
- package/template/scene.json +4 -0
- package/template/src/main.ts +11 -0
- package/vendor/DOCS.md +447 -0
- package/vendor/agent/appRun.mjs +520 -0
- package/vendor/agent/assets/brief.mjs +242 -0
- package/vendor/agent/assets/collider.mjs +531 -0
- package/vendor/agent/assets/environments/index.mjs +12 -0
- package/vendor/agent/assets/environments/worldlabs.mjs +161 -0
- package/vendor/agent/assets/fetch.mjs +168 -0
- package/vendor/agent/assets/footprint.mjs +13 -0
- package/vendor/agent/assets/gltf.mjs +547 -0
- package/vendor/agent/assets/hdr.mjs +269 -0
- package/vendor/agent/assets/imageOps.mjs +171 -0
- package/vendor/agent/assets/images/codex.mjs +307 -0
- package/vendor/agent/assets/images/fal.mjs +75 -0
- package/vendor/agent/assets/images/gemini.mjs +84 -0
- package/vendor/agent/assets/images/index.mjs +25 -0
- package/vendor/agent/assets/images/openai.mjs +75 -0
- package/vendor/agent/assets/images/stability.mjs +71 -0
- package/vendor/agent/assets/images/views.mjs +31 -0
- package/vendor/agent/assets/import.mjs +1352 -0
- package/vendor/agent/assets/inspect.mjs +465 -0
- package/vendor/agent/assets/jobs.mjs +196 -0
- package/vendor/agent/assets/ktx2.mjs +290 -0
- package/vendor/agent/assets/ledger.mjs +466 -0
- package/vendor/agent/assets/net.mjs +254 -0
- package/vendor/agent/assets/prices.json +39 -0
- package/vendor/agent/assets/providers/fal.mjs +115 -0
- package/vendor/agent/assets/providers/index.mjs +22 -0
- package/vendor/agent/assets/providers/meshy.mjs +119 -0
- package/vendor/agent/assets/providers/tripo.mjs +188 -0
- package/vendor/agent/assets/sources/ambientcg.mjs +129 -0
- package/vendor/agent/assets/sources/index.mjs +23 -0
- package/vendor/agent/assets/sources/polyhaven.mjs +237 -0
- package/vendor/agent/assets/sources/polypizza.mjs +121 -0
- package/vendor/agent/assets/splat.mjs +631 -0
- package/vendor/agent/assets/targets.mjs +122 -0
- package/vendor/agent/assets/tile.mjs +261 -0
- package/vendor/agent/assets/unzip.mjs +180 -0
- package/vendor/agent/blender/cleanup.py +360 -0
- package/vendor/agent/blender/convert.py +167 -0
- package/vendor/agent/blender/find.mjs +192 -0
- package/vendor/agent/blender/nw_export.py +104 -0
- package/vendor/agent/blender/nw_rubric.py +426 -0
- package/vendor/agent/blender/run.mjs +193 -0
- package/vendor/agent/blender/runner.py +252 -0
- package/vendor/agent/blender/sheet.py +743 -0
- package/vendor/agent/depth.mjs +134 -0
- package/vendor/agent/director/board.mjs +451 -0
- package/vendor/agent/director/contracts.mjs +663 -0
- package/vendor/agent/director/director.mjs +2365 -0
- package/vendor/agent/director/estimate.mjs +200 -0
- package/vendor/agent/director/gate.mjs +802 -0
- package/vendor/agent/director/limits.json +16 -0
- package/vendor/agent/director/methods.mjs +457 -0
- package/vendor/agent/director/policy.json +33 -0
- package/vendor/agent/director/prompts.mjs +244 -0
- package/vendor/agent/director/reading.mjs +341 -0
- package/vendor/agent/director/router.mjs +184 -0
- package/vendor/agent/director/seams.mjs +243 -0
- package/vendor/agent/director/session.mjs +643 -0
- package/vendor/agent/director/store.mjs +119 -0
- package/vendor/agent/director/taskGate.mjs +110 -0
- package/vendor/agent/director/teamLedger.mjs +118 -0
- package/vendor/agent/director/triage.mjs +63 -0
- package/vendor/agent/downloads.cjs +363 -0
- package/vendor/agent/flow.mjs +78 -0
- package/vendor/agent/guard.mjs +613 -0
- package/vendor/agent/host.mjs +1736 -0
- package/vendor/agent/language.mjs +58 -0
- package/vendor/agent/ledger.mjs +360 -0
- package/vendor/agent/locale.cjs +186 -0
- package/vendor/agent/loop/capacity.mjs +74 -0
- package/vendor/agent/loop/compose.mjs +127 -0
- package/vendor/agent/loop/gate.mjs +205 -0
- package/vendor/agent/loop/judge.mjs +189 -0
- package/vendor/agent/loop/levels.mjs +273 -0
- package/vendor/agent/loop/state.mjs +358 -0
- package/vendor/agent/notes.cjs +278 -0
- package/vendor/agent/pace.mjs +258 -0
- package/vendor/agent/panels.mjs +431 -0
- package/vendor/agent/prompt.mjs +342 -0
- package/vendor/agent/reference/board.mjs +410 -0
- package/vendor/agent/reference/compose.mjs +364 -0
- package/vendor/agent/reference/decode.mjs +56 -0
- package/vendor/agent/reference/facts.mjs +1874 -0
- package/vendor/agent/reference/png.mjs +107 -0
- package/vendor/agent/reference/records.mjs +63 -0
- package/vendor/agent/reference/web.mjs +252 -0
- package/vendor/agent/roles/artist.mjs +69 -0
- package/vendor/agent/roles/builder.mjs +79 -0
- package/vendor/agent/roles/checks.mjs +223 -0
- package/vendor/agent/roles/common.mjs +188 -0
- package/vendor/agent/roles/critic.mjs +171 -0
- package/vendor/agent/roles/index.mjs +39 -0
- package/vendor/agent/roles/modeller.mjs +142 -0
- package/vendor/agent/roles/qa.mjs +58 -0
- package/vendor/agent/roles/rubrics.mjs +79 -0
- package/vendor/agent/roles/sound.mjs +69 -0
- package/vendor/agent/rounds.cjs +333 -0
- package/vendor/agent/shared.mjs +284 -0
- package/vendor/agent/stopGate.mjs +574 -0
- package/vendor/agent/subagents.mjs +129 -0
- package/vendor/agent/tools/assets.mjs +499 -0
- package/vendor/agent/tools/blender.mjs +754 -0
- package/vendor/agent/tools/cards.mjs +479 -0
- package/vendor/agent/tools/choices.mjs +479 -0
- package/vendor/agent/tools/compose.mjs +74 -0
- package/vendor/agent/tools/environment.mjs +488 -0
- package/vendor/agent/tools/eyes.mjs +733 -0
- package/vendor/agent/tools/generate.mjs +338 -0
- package/vendor/agent/tools/guide.mjs +46 -0
- package/vendor/agent/tools/harness.mjs +193 -0
- package/vendor/agent/tools/image.mjs +643 -0
- package/vendor/agent/tools/index.mjs +162 -0
- package/vendor/agent/tools/look.mjs +578 -0
- package/vendor/agent/tools/loop.mjs +858 -0
- package/vendor/agent/tools/others.mjs +123 -0
- package/vendor/agent/tools/pictures.mjs +535 -0
- package/vendor/agent/tools/reference.mjs +366 -0
- package/vendor/agent/transcripts.mjs +118 -0
- package/vendor/agent-loop.mjs +602 -0
- package/vendor/agent-plugin/.claude-plugin/plugin.json +5 -0
- package/vendor/agent-plugin/skills/art-direction/SKILL.md +82 -0
- package/vendor/agent-plugin/skills/asset-legality/SKILL.md +101 -0
- package/vendor/agent-plugin/skills/asset-sources/SKILL.md +111 -0
- package/vendor/agent-plugin/skills/blender-modeling/SKILL.md +97 -0
- package/vendor/agent-plugin/skills/look-dev/SKILL.md +104 -0
- package/vendor/agent-plugin/skills/playtesting/SKILL.md +74 -0
- package/vendor/agent-plugin/skills/reference-loop/SKILL.md +102 -0
- package/vendor/agent-plugin/skills/sound-design/SKILL.md +60 -0
- package/vendor/agent-plugin/skills/style/SKILL.md +35 -0
- package/vendor/agent-plugin/skills/tsl-r185/SKILL.md +107 -0
- package/vendor/auth.cjs +570 -0
- package/vendor/build.cjs +953 -0
- package/vendor/catalog.json +455 -0
- package/vendor/connectors.cjs +688 -0
- package/vendor/eyes.mjs +733 -0
- package/vendor/gameExports.json +1390 -0
- package/vendor/git.cjs +222 -0
- package/vendor/models.json +57 -0
- package/vendor/publish.cjs +1018 -0
- package/vendor/refBoard.cjs +301 -0
- package/vendor/schema/dist/assets.d.ts +335 -0
- package/vendor/schema/dist/assets.js +439 -0
- package/vendor/schema/dist/brief.d.ts +357 -0
- package/vendor/schema/dist/brief.js +302 -0
- package/vendor/schema/dist/common.d.ts +9 -0
- package/vendor/schema/dist/common.js +13 -0
- package/vendor/schema/dist/config.d.ts +406 -0
- package/vendor/schema/dist/config.js +355 -0
- package/vendor/schema/dist/contract.d.ts +599 -0
- package/vendor/schema/dist/contract.js +1146 -0
- package/vendor/schema/dist/index.d.ts +14 -0
- package/vendor/schema/dist/index.js +21 -0
- package/vendor/schema/dist/look.d.ts +463 -0
- package/vendor/schema/dist/look.js +681 -0
- package/vendor/schema/dist/lookStats.d.ts +230 -0
- package/vendor/schema/dist/lookStats.js +768 -0
- package/vendor/schema/dist/pilot.d.ts +32 -0
- package/vendor/schema/dist/pilot.js +44 -0
- package/vendor/schema/dist/publish.d.ts +214 -0
- package/vendor/schema/dist/publish.js +291 -0
- package/vendor/schema/dist/scene.d.ts +75 -0
- package/vendor/schema/dist/scene.js +120 -0
- package/vendor/schema/dist/skyLight.d.ts +141 -0
- package/vendor/schema/dist/skyLight.js +436 -0
- package/vendor/schema/dist/style.d.ts +131 -0
- package/vendor/schema/dist/style.js +155 -0
- package/vendor/schema/package.json +1 -0
- package/vendor/selectionPrompt.mjs +51 -0
- package/vendor/useTools.mjs +195 -0
- package/vendor/userMessage.mjs +26 -0
- package/web-dist/assets/GaussianSplatUtils-CptQkDVX.js +1 -0
- package/web-dist/assets/KTX2Loader-C53LJqss.js +2 -0
- package/web-dist/assets/SPZLoader-BQ3tjaTv.js +1 -0
- package/web-dist/assets/gaussianSplat-_9tcWegB.js +1 -0
- package/web-dist/assets/index-Baka-ZO7.js +693 -0
- package/web-dist/assets/index-CcjyyQco.css +1 -0
- package/web-dist/assets/meshopt_decoder.module-BvwdjiD3.js +1 -0
- package/web-dist/assets/zstddec.module-CfFeQW7d.js +1 -0
- package/web-dist/index.html +34 -0
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
// The registry of the studio's own tools (the "nw" tools). Each stream's
|
|
2
|
+
// module exports TOOLS, a list of ToolDefs (name, description, zod shape,
|
|
3
|
+
// handler, flags), and RPC_METHODS, the main-process calls its handlers make.
|
|
4
|
+
// From the same defs this file makes the Agent SDK's tools for Claude and the
|
|
5
|
+
// plain JSON Schema specs the other vendors' loop sends, and both loops run a
|
|
6
|
+
// call through runDef, so errors and verification work the same for every
|
|
7
|
+
// model.
|
|
8
|
+
//
|
|
9
|
+
// A module that is not there yet is skipped, so a tree where one stream has
|
|
10
|
+
// landed and another has not still runs; any other import error is thrown,
|
|
11
|
+
// so a syntax error never silently drops tools.
|
|
12
|
+
|
|
13
|
+
import { tool } from '@anthropic-ai/claude-agent-sdk'
|
|
14
|
+
import { z } from 'zod'
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* @typedef {{ data: string, mime: 'image/png' | 'image/jpeg' }} ToolImage base64, no data: prefix
|
|
18
|
+
* @typedef {{ text: string, images?: ToolImage[], isError?: boolean, verifies?: 'view' | 'check' | null }} ToolResult
|
|
19
|
+
* verifies: what this call verified, when it is not the def's; null for nothing.
|
|
20
|
+
* @typedef {object} ToolDef
|
|
21
|
+
* @property {string} name
|
|
22
|
+
* @property {string} description
|
|
23
|
+
* @property {Record<string, import('zod').ZodType>} shape
|
|
24
|
+
* @property {(args: object, ctx: object) => Promise<ToolResult>} handler
|
|
25
|
+
* @property {boolean} [readOnly]
|
|
26
|
+
* @property {'view' | 'check'} [verifies]
|
|
27
|
+
* @property {boolean} [mainOnly]
|
|
28
|
+
*/
|
|
29
|
+
|
|
30
|
+
/** In this order: names must be unique across them. */
|
|
31
|
+
export const TOOL_MODULES = ['./harness.mjs', './eyes.mjs', './cards.mjs', './choices.mjs', './loop.mjs', './blender.mjs', './look.mjs', './assets.mjs', './generate.mjs', './environment.mjs', './image.mjs', './reference.mjs', './compose.mjs', './others.mjs', './pictures.mjs']
|
|
32
|
+
|
|
33
|
+
/** Each module with what it exports, or null when it is not there yet. */
|
|
34
|
+
export async function loadToolModules({ log } = {}) {
|
|
35
|
+
const out = []
|
|
36
|
+
for (const rel of TOOL_MODULES) {
|
|
37
|
+
const url = new URL(rel, import.meta.url)
|
|
38
|
+
try {
|
|
39
|
+
out.push({ file: rel, module: await import(url.href) })
|
|
40
|
+
} catch (err) {
|
|
41
|
+
// Only the module itself missing; a missing import inside it is a real error.
|
|
42
|
+
if (err?.code === 'ERR_MODULE_NOT_FOUND' && err.url === url.href) {
|
|
43
|
+
log?.(`[agent] tools: ${rel} is not there yet; its tools are left out`)
|
|
44
|
+
out.push({ file: rel, module: null })
|
|
45
|
+
continue
|
|
46
|
+
}
|
|
47
|
+
throw err
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
return out
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/** Every ToolDef, in module order. Throws on a duplicate name. */
|
|
54
|
+
export async function loadTools(options) {
|
|
55
|
+
const defs = []
|
|
56
|
+
const seen = new Set()
|
|
57
|
+
for (const { file, module } of await loadToolModules(options)) {
|
|
58
|
+
for (const def of module?.TOOLS ?? []) {
|
|
59
|
+
if (seen.has(def.name)) throw new Error(`Two tools are named ${def.name} (the second in ${file}).`)
|
|
60
|
+
seen.add(def.name)
|
|
61
|
+
defs.push(def)
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
return defs
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/** A ToolResult as MCP content. */
|
|
68
|
+
export function toContent(result) {
|
|
69
|
+
return {
|
|
70
|
+
content: [
|
|
71
|
+
{ type: 'text', text: result.text ?? '' },
|
|
72
|
+
...(result.images ?? []).map((i) => ({ type: 'image', data: i.data, mimeType: i.mime })),
|
|
73
|
+
],
|
|
74
|
+
...(result.isError ? { isError: true } : {}),
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/** The tools whose writes under .nowhere/ the mood board shows: the
|
|
79
|
+
* kickoff and the round (loop.json), the targets (drawn into
|
|
80
|
+
* .nowhere/targets/, copied onto the board), the pictures card (the board's
|
|
81
|
+
* copies) and image_generate (drawn targets, generated pictures). */
|
|
82
|
+
const MOOD_WRITERS = new Set(['nw_ask_kickoff', 'nw_ask_targets', 'nw_round', 'nw_ask_pictures', 'image_generate'])
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* Runs one call: the arguments through the def's schema (the other vendors
|
|
86
|
+
* send them unchecked, and without the defaults), the handler with anything
|
|
87
|
+
* it throws turned into an error result, then the Stop gate's record of a
|
|
88
|
+
* look or a passing check.
|
|
89
|
+
*/
|
|
90
|
+
export async function runDef(def, args, ctx) {
|
|
91
|
+
let result
|
|
92
|
+
const parsed = z.object(def.shape).safeParse(args ?? {})
|
|
93
|
+
if (!parsed.success) {
|
|
94
|
+
const problems = parsed.error.issues.map((i) => `${i.path.join('.') || 'input'}: ${i.message}`).join('; ')
|
|
95
|
+
return { text: `The input for ${def.name} is not valid: ${problems}`, isError: true }
|
|
96
|
+
}
|
|
97
|
+
try {
|
|
98
|
+
result = await def.handler(parsed.data, ctx)
|
|
99
|
+
} catch (err) {
|
|
100
|
+
result = { text: err?.message ?? String(err), isError: true }
|
|
101
|
+
}
|
|
102
|
+
if (!result || typeof result !== 'object') result = { text: String(result ?? 'Done.') }
|
|
103
|
+
if (typeof result.text !== 'string') result = { ...result, text: String(result.text ?? '') }
|
|
104
|
+
// A frame-time reading a tool carries (nw_status and nw_check's perf) is
|
|
105
|
+
// what the reference loop's stop gate and approval card read.
|
|
106
|
+
if (result.perf && typeof result.perf === 'object') {
|
|
107
|
+
try {
|
|
108
|
+
ctx?.run?.notePerf?.(result.perf)
|
|
109
|
+
} catch {
|
|
110
|
+
// the reading is a convenience; the tool's answer stands
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
// A tool that writes what the mood board shows where the project's
|
|
114
|
+
// watcher does not look (.nowhere/: loop.json, the drawn targets, the
|
|
115
|
+
// reference board's copies) tells main, which tells an open board.
|
|
116
|
+
if (MOOD_WRITERS.has(def.name)) {
|
|
117
|
+
try {
|
|
118
|
+
ctx?.post?.({ type: 'mood-changed' })
|
|
119
|
+
} catch {
|
|
120
|
+
// the board reads it again when it next opens
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
const kind = result.verifies === undefined ? def.verifies : result.verifies
|
|
124
|
+
if (!result.isError && kind) {
|
|
125
|
+
try {
|
|
126
|
+
await ctx?.run?.record?.(kind)
|
|
127
|
+
} catch {
|
|
128
|
+
// the record is a convenience; the tool's answer stands
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
return result
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
/** The SDK tool for a def. `ctxFor()` gives the running request's ctx. */
|
|
135
|
+
export function toSdkTool(def, ctxFor) {
|
|
136
|
+
return tool(def.name, def.description, def.shape, async (args) => toContent(await runDef(def, args, ctxFor())), {
|
|
137
|
+
annotations: def.readOnly ? { readOnlyHint: true } : undefined,
|
|
138
|
+
})
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
/** A JSON Schema in the subset every vendor takes: no additionalProperties
|
|
142
|
+
* at any depth (zod puts it on every object, and Gemini's function
|
|
143
|
+
* declarations have refused it), and exclusiveMinimum and exclusiveMaximum
|
|
144
|
+
* as plain bounds. */
|
|
145
|
+
function plainSchema(node) {
|
|
146
|
+
if (Array.isArray(node)) return node.map(plainSchema)
|
|
147
|
+
if (!node || typeof node !== 'object') return node
|
|
148
|
+
const out = {}
|
|
149
|
+
for (const [key, value] of Object.entries(node)) {
|
|
150
|
+
if (key === '$schema' || key === 'additionalProperties' || key === 'exclusiveMinimum' || key === 'exclusiveMaximum') continue
|
|
151
|
+
out[key] = plainSchema(value)
|
|
152
|
+
}
|
|
153
|
+
// runDef's parse still holds a call to the exact bound.
|
|
154
|
+
if (typeof node.exclusiveMinimum === 'number') out.minimum = Math.max(node.exclusiveMinimum, out.minimum ?? -Infinity)
|
|
155
|
+
if (typeof node.exclusiveMaximum === 'number') out.maximum = Math.min(node.exclusiveMaximum, out.maximum ?? Infinity)
|
|
156
|
+
return out
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
/** The provider-neutral spec the other vendors' loop sends. */
|
|
160
|
+
export function toVendorSpec(def) {
|
|
161
|
+
return { name: def.name, description: def.description, parameters: plainSchema(z.toJSONSchema(z.object(def.shape))) }
|
|
162
|
+
}
|