@noodleseed/one 0.67.0 → 0.68.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/dist/agents.d.ts +2 -1
- package/dist/agents.d.ts.map +1 -1
- package/dist/agents.js +70 -20
- package/dist/agents.js.map +1 -1
- package/dist/cli.js +1 -1
- package/dist/cli.js.map +1 -1
- package/dist/commands/catalog.d.ts.map +1 -1
- package/dist/commands/catalog.js +1 -0
- package/dist/commands/catalog.js.map +1 -1
- package/dist/skills-update.d.ts +7 -0
- package/dist/skills-update.d.ts.map +1 -1
- package/dist/skills-update.js +9 -3
- package/dist/skills-update.js.map +1 -1
- package/node_modules/@noodle-borg/agent-kit/dist/generated/example-files.js +1 -1
- package/node_modules/@noodle-borg/agent-kit/dist/generated/example-files.js.map +1 -1
- package/node_modules/@noodle-borg/agent-kit/dist/index.d.ts.map +1 -1
- package/node_modules/@noodle-borg/agent-kit/dist/index.js +8 -13
- package/node_modules/@noodle-borg/agent-kit/dist/index.js.map +1 -1
- package/node_modules/@noodle-borg/agent-kit/dist/plugin-bundle.d.ts.map +1 -1
- package/node_modules/@noodle-borg/agent-kit/dist/plugin-bundle.js +4 -3
- package/node_modules/@noodle-borg/agent-kit/dist/plugin-bundle.js.map +1 -1
- package/node_modules/@noodle-borg/agent-kit/dist/skill-app-playbook-ref.d.ts +2 -0
- package/node_modules/@noodle-borg/agent-kit/dist/skill-app-playbook-ref.d.ts.map +1 -0
- package/node_modules/@noodle-borg/agent-kit/dist/skill-app-playbook-ref.js +59 -0
- package/node_modules/@noodle-borg/agent-kit/dist/skill-app-playbook-ref.js.map +1 -0
- package/node_modules/@noodle-borg/agent-kit/dist/skill-connect-refs.d.ts.map +1 -1
- package/node_modules/@noodle-borg/agent-kit/dist/skill-connect-refs.js +60 -20
- package/node_modules/@noodle-borg/agent-kit/dist/skill-connect-refs.js.map +1 -1
- package/node_modules/@noodle-borg/agent-kit/dist/skill-content.d.ts +1 -8
- package/node_modules/@noodle-borg/agent-kit/dist/skill-content.d.ts.map +1 -1
- package/node_modules/@noodle-borg/agent-kit/dist/skill-content.js +14 -85
- package/node_modules/@noodle-borg/agent-kit/dist/skill-content.js.map +1 -1
- package/node_modules/@noodle-borg/agent-kit/dist/skill-design-refs.d.ts.map +1 -1
- package/node_modules/@noodle-borg/agent-kit/dist/skill-design-refs.js +2 -1
- package/node_modules/@noodle-borg/agent-kit/dist/skill-design-refs.js.map +1 -1
- package/node_modules/@noodle-borg/agent-kit/dist/skill-operations-refs.d.ts +2 -1
- package/node_modules/@noodle-borg/agent-kit/dist/skill-operations-refs.d.ts.map +1 -1
- package/node_modules/@noodle-borg/agent-kit/dist/skill-operations-refs.js +114 -150
- package/node_modules/@noodle-borg/agent-kit/dist/skill-operations-refs.js.map +1 -1
- package/node_modules/@noodle-borg/agent-kit/dist/skill-router.d.ts +17 -0
- package/node_modules/@noodle-borg/agent-kit/dist/skill-router.d.ts.map +1 -0
- package/node_modules/@noodle-borg/agent-kit/dist/skill-router.js +160 -0
- package/node_modules/@noodle-borg/agent-kit/dist/skill-router.js.map +1 -0
- package/node_modules/@noodle-borg/agent-kit/dist/skill-server-playbook-ref.d.ts +2 -0
- package/node_modules/@noodle-borg/agent-kit/dist/skill-server-playbook-ref.d.ts.map +1 -0
- package/node_modules/@noodle-borg/agent-kit/dist/skill-server-playbook-ref.js +61 -0
- package/node_modules/@noodle-borg/agent-kit/dist/skill-server-playbook-ref.js.map +1 -0
- package/node_modules/@noodle-borg/agent-kit/dist/skill-verification-ref.d.ts +2 -0
- package/node_modules/@noodle-borg/agent-kit/dist/skill-verification-ref.d.ts.map +1 -0
- package/node_modules/@noodle-borg/agent-kit/dist/skill-verification-ref.js +72 -0
- package/node_modules/@noodle-borg/agent-kit/dist/skill-verification-ref.js.map +1 -0
- package/node_modules/@noodle-borg/agent-kit/package.json +1 -1
- package/package.json +1 -1
|
@@ -3,13 +3,16 @@
|
|
|
3
3
|
// actually returned, then prove the mapping returns real data before building the app.
|
|
4
4
|
export function renderConnectAnApiReference() {
|
|
5
5
|
return [
|
|
6
|
-
'#
|
|
6
|
+
'# Outcome',
|
|
7
7
|
'',
|
|
8
|
-
|
|
9
|
-
'drift. Probe the live API, learn the real shape, then encode it as a `connector`. The loop:',
|
|
8
|
+
'Connect a real API to a focused MCP product using managed credentials, mappings derived from observed responses, and representative live-read evidence. A connector that merely compiles is not complete.',
|
|
10
9
|
'',
|
|
11
10
|
'## Contents',
|
|
12
11
|
'',
|
|
12
|
+
'- Use when',
|
|
13
|
+
'- Do not use when',
|
|
14
|
+
'- Required inputs',
|
|
15
|
+
'- Workflow',
|
|
13
16
|
'- Secure the key first',
|
|
14
17
|
'- Probe the live API',
|
|
15
18
|
'- Model the connector from the observed shape',
|
|
@@ -18,9 +21,30 @@ export function renderConnectAnApiReference() {
|
|
|
18
21
|
'- Design intent tools',
|
|
19
22
|
'- Set the secret for local runs',
|
|
20
23
|
'- Prove real output',
|
|
21
|
-
'-
|
|
24
|
+
'- Verification evidence',
|
|
25
|
+
'- Recovery paths',
|
|
26
|
+
'- Stop conditions',
|
|
22
27
|
'',
|
|
23
|
-
'##
|
|
28
|
+
'## Use when',
|
|
29
|
+
'',
|
|
30
|
+
'- The user provides credentials, a reachable API, or an OpenAPI document and wants real MCP behavior backed by it.',
|
|
31
|
+
'- Existing connector behavior compiles but still needs proof against the actual service and data shape.',
|
|
32
|
+
'',
|
|
33
|
+
'## Do not use when',
|
|
34
|
+
'',
|
|
35
|
+
'- The task is a local/static MCP capability with no external data source.',
|
|
36
|
+
'- The user only wants a widget, deployment, publication, or diagnosis unrelated to API behavior; select that route.',
|
|
37
|
+
'- Required credentials or authority are unavailable. Do not bypass authentication or substitute fabricated payloads for live evidence.',
|
|
38
|
+
'',
|
|
39
|
+
'## Required inputs',
|
|
40
|
+
'',
|
|
41
|
+
'Identify the API base URL, authentication scheme, one representative safe read, the user intent it serves, and either an OpenAPI document or one sanitized example response. For writes, also establish the effect, a safe test target, and explicit user approval before any live write.',
|
|
42
|
+
'',
|
|
43
|
+
'Do not guess or invent a field, schema, endpoint, pagination contract, or authentication behavior. Documentation is a hypothesis until a representative live read confirms the response actually returned.',
|
|
44
|
+
'',
|
|
45
|
+
'## Workflow',
|
|
46
|
+
'',
|
|
47
|
+
'### Secure the key first',
|
|
24
48
|
'',
|
|
25
49
|
'Never inline or log the key. Have the user put it in an environment variable, then store it as a',
|
|
26
50
|
'managed secret and reference it only as `secret(...)`:',
|
|
@@ -33,7 +57,7 @@ export function renderConnectAnApiReference() {
|
|
|
33
57
|
'In `server.ts` the key is only ever `secret("SOME_API_KEY")` — keep the raw value out of code, tests,',
|
|
34
58
|
'prompts, logs, and generated files.',
|
|
35
59
|
'',
|
|
36
|
-
'
|
|
60
|
+
'### Probe the live API',
|
|
37
61
|
'',
|
|
38
62
|
'Learn the actual response shape empirically. Two ways — capture one real example response per endpoint',
|
|
39
63
|
'you will use, and read its field names, nesting, array shapes, pagination, and id-vs-label fields:',
|
|
@@ -45,7 +69,7 @@ export function renderConnectAnApiReference() {
|
|
|
45
69
|
" '${response}' }`), `noodle secrets set` the key, then `noodle tools call` it to see the real payload",
|
|
46
70
|
' in-process.',
|
|
47
71
|
'',
|
|
48
|
-
'
|
|
72
|
+
'### Model the connector from the observed shape',
|
|
49
73
|
'',
|
|
50
74
|
'Encode the API as an HTTP connector, mapping only the fields you actually saw into a small typed',
|
|
51
75
|
'`output`:',
|
|
@@ -61,7 +85,7 @@ export function renderConnectAnApiReference() {
|
|
|
61
85
|
'The full connector shape, every `auth.kind`, and compute connectors are in',
|
|
62
86
|
'`references/authoring-workflow.md`.',
|
|
63
87
|
'',
|
|
64
|
-
'
|
|
88
|
+
'### Return a list',
|
|
65
89
|
'',
|
|
66
90
|
'Most real tools return a variable-length list (search results, a user’s tasks). Bind the **whole array** — a single `${response.path}` returns the referenced value verbatim, arrays included:',
|
|
67
91
|
'',
|
|
@@ -92,7 +116,7 @@ export function renderConnectAnApiReference() {
|
|
|
92
116
|
"response: { tasks: '${response.items}' },",
|
|
93
117
|
'```',
|
|
94
118
|
'',
|
|
95
|
-
'
|
|
119
|
+
'### Create, update, delete',
|
|
96
120
|
'',
|
|
97
121
|
'Pair the read/list with the mutations your intent tools need:',
|
|
98
122
|
"- **Create / update** — `method: 'POST'` / `'PATCH'`; author the body as `request: { field: '${input.x}' }` (do not nest it under `body`). It is JSON by default; use `requestEncoding: 'form-urlencoded'` only when the API requires a URLSearchParams body. URL query params remain the operation-level `query: [...]` array.",
|
|
@@ -122,14 +146,14 @@ export function renderConnectAnApiReference() {
|
|
|
122
146
|
'},',
|
|
123
147
|
'```',
|
|
124
148
|
'',
|
|
125
|
-
'
|
|
149
|
+
'### Design intent tools',
|
|
126
150
|
'',
|
|
127
|
-
'
|
|
151
|
+
'Create intent-shaped tools around what the user says, not 1:1 around endpoints. Pair an id-taking action with a',
|
|
128
152
|
'find/search operation that returns `{ id, label }` summaries so the model resolves text → id itself,',
|
|
129
153
|
'and map each response to a few labelled fields the model can speak from. See the "Design tools for the',
|
|
130
154
|
'model" section of `references/authoring-workflow.md`.',
|
|
131
155
|
'',
|
|
132
|
-
'
|
|
156
|
+
'### Set the secret for local runs',
|
|
133
157
|
'',
|
|
134
158
|
'Local `dev`, smoke commands, secrets, and variables resolve one effective target: explicit flags, then the project link, then the saved CLI target, then local defaults. Set the secret through that same target:',
|
|
135
159
|
'',
|
|
@@ -142,20 +166,36 @@ export function renderConnectAnApiReference() {
|
|
|
142
166
|
'',
|
|
143
167
|
'Local secrets live in `./.env.noodle` (never commit it). A required `secret(...)` or `variable(...)` that cannot resolve fails boot closed. `noodle tools call` / `noodle test` / `noodle dev` / `noodle devtools` stop before exposing an empty endpoint and print the exact effective target plus recovery command.',
|
|
144
168
|
'',
|
|
145
|
-
'
|
|
169
|
+
'### Prove real output',
|
|
146
170
|
'',
|
|
147
171
|
'`noodle validate` / `noodle test` prove a connector tool *compiles and registers* — not that its',
|
|
148
172
|
'mapping returns data. With the secret set, run a live read: `noodle tools call <read_tool> --args',
|
|
149
173
|
"'{…}'` executes the connector against the real API in-process. Confirm the mapped fields are populated,",
|
|
150
|
-
'not `undefined`; if they are empty, fix
|
|
151
|
-
'Only run a live write
|
|
174
|
+
'not `undefined`; if they are empty, distinguish a legitimate empty result from a missing or incorrect mapping, fix `${response…}` paths against the real payload when needed, and re-run.',
|
|
175
|
+
'Only run a live write after explicit user approval and when a safe test target and expected effect are known.',
|
|
176
|
+
'',
|
|
177
|
+
'## Verification evidence',
|
|
178
|
+
'',
|
|
179
|
+
'- **Credential path:** the raw credential remained in an environment variable and the managed `secret(...)` path for the same effective local target.',
|
|
180
|
+
'- **Observed shape:** a representative safe live read established the real fields, nesting, arrays, pagination, and empty-result behavior used by the mapping.',
|
|
181
|
+
'- **Local proof:** `noodle validate --json` and `noodle test --json` succeeded, then `noodle tools call` returned populated mapped fields or an intentionally verified empty result.',
|
|
182
|
+
'- **Writes:** name the approval and safe target used, or report writes as not run.',
|
|
183
|
+
'- **Hosted boundary:** local proof does not prove hosted credentials, deployment health, or host behavior. Report hosted checks as not run unless a separate requested route exercised them.',
|
|
184
|
+
'',
|
|
185
|
+
'## Recovery paths',
|
|
186
|
+
'',
|
|
187
|
+
'- Authentication failure: verify the connector auth kind, managed secret name, and effective local target without printing the credential.',
|
|
188
|
+
'- Successful HTTP call with `undefined` fields: compare the mapping with one sanitized observed response, correct the path, and rerun the same read.',
|
|
189
|
+
'- Legitimate empty result: test a second known query or record the empty case as intentional; do not rewrite a correct mapping merely to manufacture data.',
|
|
190
|
+
'- Response too broad for the model: narrow it with response mapping, projection, or a separate compute connector; do not rely on a Zod output to strip runtime fields.',
|
|
191
|
+
'- Repeated external failure: stop after bounded attempts and report the sanitized status, endpoint class, evidence already proven, and exact external action needed.',
|
|
152
192
|
'',
|
|
153
|
-
'##
|
|
193
|
+
'## Stop conditions',
|
|
154
194
|
'',
|
|
155
|
-
'
|
|
156
|
-
'
|
|
157
|
-
'
|
|
158
|
-
'
|
|
195
|
+
'- Stop complete when the representative safe read returns populated mapped fields or an intentionally verified empty result through the same effective local target.',
|
|
196
|
+
'- Stop before a live write without explicit approval, a known effect, and a safe target.',
|
|
197
|
+
'- Stop blocked when credentials, a reachable service, a representative input, or a required private schema is unavailable.',
|
|
198
|
+
'- Do not continue into App design, deployment, or publication unless the user requested that next outcome; route to the corresponding primary playbook instead.',
|
|
159
199
|
].join('\n');
|
|
160
200
|
}
|
|
161
201
|
//# sourceMappingURL=skill-connect-refs.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"skill-connect-refs.js","sourceRoot":"","sources":["../src/skill-connect-refs.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,oGAAoG;AACpG,uFAAuF;AAEvF,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,
|
|
1
|
+
{"version":3,"file":"skill-connect-refs.js","sourceRoot":"","sources":["../src/skill-connect-refs.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,16 +1,9 @@
|
|
|
1
|
-
import type { AgentTarget } from './index.js';
|
|
2
|
-
export declare const SKILL_DESCRIPTION: string;
|
|
3
1
|
/** A reference file emitted under the skill directory, one level deep. */
|
|
4
2
|
export interface SkillReference {
|
|
5
3
|
readonly relPath: string;
|
|
6
4
|
readonly render: () => string;
|
|
7
5
|
}
|
|
8
|
-
|
|
9
|
-
* The one-line routing index for every reference file, shared verbatim by the project-local router
|
|
10
|
-
* and the global authoring-plugin bootstrap router so the two cannot drift.
|
|
11
|
-
*/
|
|
12
|
-
export declare const REFERENCE_INDEX_LINES: readonly string[];
|
|
13
|
-
export declare function skillRouterBody(target: AgentTarget): string;
|
|
6
|
+
export { REFERENCE_INDEX_LINES, SKILL_DESCRIPTION, SKILL_ROUTES, skillRouterBody, } from './skill-router.js';
|
|
14
7
|
export declare function renderSdkSurfaceReference(): string;
|
|
15
8
|
export declare function renderCliCommandsReference(): string;
|
|
16
9
|
export declare function renderAgentContractReference(): string;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"skill-content.d.ts","sourceRoot":"","sources":["../src/skill-content.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"skill-content.d.ts","sourceRoot":"","sources":["../src/skill-content.ts"],"names":[],"mappings":"AAkCA,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAoO3B,wBAAgB,yBAAyB,IAAI,MAAM,CA2ClD;AAMD,wBAAgB,0BAA0B,IAAI,MAAM,CAgCnD;AAMD,wBAAgB,4BAA4B,IAAI,MAAM,CAiDrD;AAMD,wBAAgB,4BAA4B,IAAI,MAAM,CAoBrD;AAMD,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAqBrD,CAAC"}
|
|
@@ -1,101 +1,26 @@
|
|
|
1
1
|
// Renderers for the hierarchical `noodle-seed` skill: one SKILL.md router plus one-level-deep
|
|
2
2
|
// reference files. Factual sections (SDK surface, CLI commands, compile errors, React hooks) are
|
|
3
3
|
// derived from the generated surface (./generated/surface.ts) + curated maps (./curated/*), so
|
|
4
|
-
// they never drift from the real SDK/CLI/compiler. This module owns the
|
|
5
|
-
//
|
|
6
|
-
// references live in
|
|
4
|
+
// they never drift from the real SDK/CLI/compiler. This module owns the reference registry, generated
|
|
5
|
+
// references, and curated agent-contract reference; skill-router.ts owns route selection, while the
|
|
6
|
+
// rest of the curated prose references live in the focused ./skill-*-ref(s).ts modules. The drift gate
|
|
7
7
|
// enforces both currency (every generated name rendered) and structure (router < 500 lines,
|
|
8
8
|
// references one level deep, long references open with a Contents TOC).
|
|
9
9
|
import { COMMAND_GROUP_ORDER, COMMAND_GROUPS } from './curated/command-groups.js';
|
|
10
10
|
import { ERROR_FIXES } from './curated/error-fixes.js';
|
|
11
11
|
import { CLI_COMMANDS, COMPILE_ERROR_CODES, SDK_EXPORTS } from './generated/surface.js';
|
|
12
12
|
import { mdTable } from './md.js';
|
|
13
|
+
import { renderBuildAnMcpAppReference } from './skill-app-playbook-ref.js';
|
|
13
14
|
import { renderAuthoringWorkflowReference, renderExamplesReference, renderWidgetsAndAppsReference, } from './skill-authoring-refs.js';
|
|
14
15
|
import { renderConnectAnApiReference } from './skill-connect-refs.js';
|
|
15
16
|
import { renderExperienceDesignReference } from './skill-design-refs.js';
|
|
16
17
|
import { renderEmbeddedAssistantReference } from './skill-embedded-assistant-ref.js';
|
|
17
18
|
import { renderFeedbackReference } from './skill-feedback-ref.js';
|
|
18
|
-
import {
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
// ----------------------------------------------------------------------------
|
|
24
|
-
/**
|
|
25
|
-
* The one-line routing index for every reference file, shared verbatim by the project-local router
|
|
26
|
-
* and the global authoring-plugin bootstrap router so the two cannot drift.
|
|
27
|
-
*/
|
|
28
|
-
export const REFERENCE_INDEX_LINES = [
|
|
29
|
-
'- `references/agent-contract.md` — the `--json` envelope, exit codes, and the three output modes.',
|
|
30
|
-
'- `references/sdk-surface.md` — what to import from `@noodleseed/one` and which builder to use.',
|
|
31
|
-
'- `references/cli-commands.md` — every `noodle` command, grouped by area.',
|
|
32
|
-
'- `references/compile-errors.md` — fix `noodle validate` errors by code.',
|
|
33
|
-
'- `references/authoring-workflow.md` — input paths (scrape / OpenAPI import / user interview), the fit check, the validate→test→dev repair loop, connectors, and secrets/variables.',
|
|
34
|
-
'- `references/embedded-assistant.md` — HTTPS origins, managed model config, deploy-before-client sequencing, backend session exchange, browser mounting, and credential boundaries.',
|
|
35
|
-
'- `references/connect-an-api.md` — given an API key: secure it, probe the live API to learn the real shape, model the connector, and prove real output before building.',
|
|
36
|
-
'- `references/experience-design.md` — design the app experience before authoring: funnel/handoff boundary, grounding, two-users, display modes, and the wireframe/UX spec.',
|
|
37
|
-
'- `references/widgets-and-apps.md` — MCP Apps, React `view` widgets, the widget hook surface, output shaping, and CSP.',
|
|
38
|
-
'- `references/test-in-hosts.md` — connect and test in ChatGPT (developer mode), Claude, agent hosts, and MCP Inspector.',
|
|
39
|
-
'- `references/troubleshooting.md` — runtime symptom → cause → fix, in-host and hosted.',
|
|
40
|
-
'- `references/deploy-and-ops.md` — login/link/deploy/status/access and hosted operations.',
|
|
41
|
-
'- `references/publishing.md` — submit to the ChatGPT apps directory and Claude connectors directory.',
|
|
42
|
-
'- `references/chatgpt-compliance.md` — the OpenAI Apps SDK pre-submission checklist (beyond the metadata gate): conversational value, helpful-UI-only, in-chat completion, UI guidelines, domain guardrails, privacy.',
|
|
43
|
-
'- `references/examples.md` — flagship example index and a canonical `server.ts`.',
|
|
44
|
-
'- `references/feedback.md` — draft sanitized product feedback, show the user the exact command, and submit only after explicit user approval.',
|
|
45
|
-
];
|
|
46
|
-
export function skillRouterBody(target) {
|
|
47
|
-
const preamble = target === 'codex'
|
|
48
|
-
? 'Use this skill for local Noodle Seed project work in Codex.'
|
|
49
|
-
: 'Use this skill for project-local Noodle Seed authoring in Claude Code; preserve generated/user instruction boundaries.';
|
|
50
|
-
return [
|
|
51
|
-
'# Noodle Seed',
|
|
52
|
-
'',
|
|
53
|
-
'Build, validate, test, deploy, and operate Noodle Seed MCP servers and apps authored in TypeScript with the `noodle` CLI. Author from the configured entrypoint (usually `server.ts`); keep the authoring surface TypeScript-only.',
|
|
54
|
-
'',
|
|
55
|
-
preamble,
|
|
56
|
-
'',
|
|
57
|
-
"**Installed-plugin execution.** When this skill is supplied by the Noodle Developer plugin, preserve the managed invocation path established by the plugin bootstrap and invoke every `noodle` command through that host bundle's managed launcher. Do not install or update a global CLI. Noodle guides and operates the lifecycle; you write and test the application source in the user's project.",
|
|
58
|
-
'',
|
|
59
|
-
'## Golden path',
|
|
60
|
-
'',
|
|
61
|
-
'This CLI is agent-native: the cold-agent-path commands speak the `--json` envelope (hosted admin/ops commands are still being normalized). Drive the loop by parsing machine state, not human prose. The full envelope, exit codes, and output modes are in `references/agent-contract.md`.',
|
|
62
|
-
'',
|
|
63
|
-
'**Discover the skill first.** Before authoring anything, read this whole `SKILL.md` and scan the `## References` index below (including `references/examples.md`) so you build from the shipped patterns — connectors that return live lists, secret scoping, widgets, testing — instead of rediscovering them. Open the references your task touches in full.',
|
|
64
|
-
'',
|
|
65
|
-
'Before authoring, design the experience — the funnel/handoff boundary, tools, widgets, display modes, and grounding — see `references/experience-design.md`. Then run the loop:',
|
|
66
|
-
'',
|
|
67
|
-
"1. **Discover** — `noodle commands --json`: every command, subcommand, flag, and exit code (don't read source).",
|
|
68
|
-
'2. **Author** — edit `src/server.ts` (the configured entrypoint); follow the capability recipe in `references/sdk-surface.md` and `references/examples.md`.',
|
|
69
|
-
'3. **Validate** — `noodle validate --json`; on failure `{ok:false,error:{code,message,fix,next,errors:[{code,path,message}]}}` — the per-field detail is in `error.errors[]`.',
|
|
70
|
-
'4. **Repair** — fix each `error.errors[]` entry at its `path`, then re-run `noodle validate --json`; `noodle validate --fix-prompt` emits ready-to-apply repair prose. Never freeform re-edit (see `references/compile-errors.md`).',
|
|
71
|
-
'5. **Smoke** — `noodle test --json`: local compile plus a loopback MCP smoke.',
|
|
72
|
-
"6. **Prove real output** — `validate`/`test` prove a connector tool *compiles and registers*, not that its response mapping returns data. Set the secret on the same effective local target with `noodle secrets set <NAME> --runtime local --from-env <ENV>` (see `references/connect-an-api.md`), then run a live read — `noodle tools call <read_tool> --args '{...}'` executes the connector against the real API in-process — and confirm the mapped fields are populated, not `undefined`, before trusting it. Only run a live write if it is safe/approved.",
|
|
73
|
-
'7. **Apps/widgets/embed** — `noodle check --json` (add `--target chatgpt|claude|embedded-assistant`), then `noodle devtools`; use `references/widgets-and-apps.md` for MCP Apps and `references/embedded-assistant.md` for a SaaS embed.',
|
|
74
|
-
'8. **Deploy** — `noodle deploy`; auth fails clean with `error.next` = `noodle login` (see `references/deploy-and-ops.md`).',
|
|
75
|
-
'9. **Wire into a host** — `noodle connect <codex|claude-code|chatgpt>` (prove it in a real host per `references/test-in-hosts.md`; debug symptoms with `references/troubleshooting.md`).',
|
|
76
|
-
'10. **Health** — `noodle metrics --agent-output`: a health verdict plus the exact next command per attention item.',
|
|
77
|
-
'',
|
|
78
|
-
'## References',
|
|
79
|
-
'',
|
|
80
|
-
'Scan all of these during discovery; open in full the ones your task touches:',
|
|
81
|
-
'',
|
|
82
|
-
...REFERENCE_INDEX_LINES,
|
|
83
|
-
'',
|
|
84
|
-
'## Product feedback',
|
|
85
|
-
'',
|
|
86
|
-
'When you discover a bug, missing capability, misleading doc, or improvement idea, draft one sanitized `noodle feedback` command per finding. Show the user the exact command and ask for explicit user approval. Do not run or submit it until approval is given. Follow `references/feedback.md`; never include customer code, secrets, personal data, or identifying project details.',
|
|
87
|
-
'',
|
|
88
|
-
'## Safety',
|
|
89
|
-
'',
|
|
90
|
-
'- Keep secrets, bearer tokens, refresh tokens, static access keys, `.env.noodle` values, and `~/.noodle/config.json` out of prompts, logs, docs, tests, and generated files.',
|
|
91
|
-
'- Do not hand-author manifest JSON/YAML, runtime artifacts, connector IR, or hosted asset metadata.',
|
|
92
|
-
'- Do not add static data-plane credential paths; hosted access is identity-based.',
|
|
93
|
-
'',
|
|
94
|
-
'## Customization',
|
|
95
|
-
'',
|
|
96
|
-
'This skill is regenerated by `noodle agents setup --write`. For project-specific standards, create a separate skill; do not edit this file or its references.',
|
|
97
|
-
].join('\n');
|
|
98
|
-
}
|
|
19
|
+
import { renderAppDirectoryComplianceReference, renderDeployAndOpsReference, renderInspectHostedReference, renderPublishingReference, renderTestInHostsReference, renderTroubleshootingReference, } from './skill-operations-refs.js';
|
|
20
|
+
import { APP_DIRECTORY_COMPLIANCE_REFERENCE } from './skill-router.js';
|
|
21
|
+
import { renderBuildAnMcpServerReference } from './skill-server-playbook-ref.js';
|
|
22
|
+
import { renderVerifyAndRecoverReference } from './skill-verification-ref.js';
|
|
23
|
+
export { REFERENCE_INDEX_LINES, SKILL_DESCRIPTION, SKILL_ROUTES, skillRouterBody, } from './skill-router.js';
|
|
99
24
|
// ----------------------------------------------------------------------------
|
|
100
25
|
// references/sdk-surface.md (GENERATED from SDK_EXPORTS + curated recipes)
|
|
101
26
|
// ----------------------------------------------------------------------------
|
|
@@ -470,16 +395,20 @@ export const SKILL_REFERENCES = [
|
|
|
470
395
|
{ relPath: 'references/cli-commands.md', render: renderCliCommandsReference },
|
|
471
396
|
{ relPath: 'references/agent-contract.md', render: renderAgentContractReference },
|
|
472
397
|
{ relPath: 'references/compile-errors.md', render: renderCompileErrorsReference },
|
|
398
|
+
{ relPath: 'references/build-an-mcp-server.md', render: renderBuildAnMcpServerReference },
|
|
473
399
|
{ relPath: 'references/authoring-workflow.md', render: renderAuthoringWorkflowReference },
|
|
474
400
|
{ relPath: 'references/embedded-assistant.md', render: renderEmbeddedAssistantReference },
|
|
475
401
|
{ relPath: 'references/connect-an-api.md', render: renderConnectAnApiReference },
|
|
402
|
+
{ relPath: 'references/build-an-mcp-app.md', render: renderBuildAnMcpAppReference },
|
|
476
403
|
{ relPath: 'references/experience-design.md', render: renderExperienceDesignReference },
|
|
477
404
|
{ relPath: 'references/widgets-and-apps.md', render: renderWidgetsAndAppsReference },
|
|
478
405
|
{ relPath: 'references/test-in-hosts.md', render: renderTestInHostsReference },
|
|
406
|
+
{ relPath: 'references/verify-and-recover.md', render: renderVerifyAndRecoverReference },
|
|
479
407
|
{ relPath: 'references/troubleshooting.md', render: renderTroubleshootingReference },
|
|
408
|
+
{ relPath: 'references/inspect-hosted.md', render: renderInspectHostedReference },
|
|
480
409
|
{ relPath: 'references/deploy-and-ops.md', render: renderDeployAndOpsReference },
|
|
481
410
|
{ relPath: 'references/publishing.md', render: renderPublishingReference },
|
|
482
|
-
{ relPath:
|
|
411
|
+
{ relPath: APP_DIRECTORY_COMPLIANCE_REFERENCE, render: renderAppDirectoryComplianceReference },
|
|
483
412
|
{ relPath: 'references/examples.md', render: renderExamplesReference },
|
|
484
413
|
{ relPath: 'references/feedback.md', render: renderFeedbackReference },
|
|
485
414
|
];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"skill-content.js","sourceRoot":"","sources":["../src/skill-content.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,iGAAiG;AACjG,+FAA+F;AAC/F,
|
|
1
|
+
{"version":3,"file":"skill-content.js","sourceRoot":"","sources":["../src/skill-content.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"skill-design-refs.d.ts","sourceRoot":"","sources":["../src/skill-design-refs.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"skill-design-refs.d.ts","sourceRoot":"","sources":["../src/skill-design-refs.ts"],"names":[],"mappings":"AAMA,wBAAgB,+BAA+B,IAAI,MAAM,CAiJxD"}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
// Curated design-side skill reference: experience-design. This is the "design the experience before
|
|
2
2
|
// authoring" phase — funnel/handoff boundary, grounding, the two-users principle, display modes, and
|
|
3
3
|
// the wireframe/UX spec — that precedes the authoring/widgets build references.
|
|
4
|
+
import { APP_DIRECTORY_COMPLIANCE_REFERENCE } from './skill-router.js';
|
|
4
5
|
export function renderExperienceDesignReference() {
|
|
5
6
|
return [
|
|
6
7
|
'# Experience design',
|
|
@@ -131,7 +132,7 @@ export function renderExperienceDesignReference() {
|
|
|
131
132
|
' architecture, demo scope, success metrics, and future enhancements — opening on the funnel-boundary',
|
|
132
133
|
' line every scope debate resolves against.',
|
|
133
134
|
'- **Wireframe** — the single-file HTML alignment artifact (anatomy above) with the embedded compliance',
|
|
134
|
-
|
|
135
|
+
` audit; see \`${APP_DIRECTORY_COMPLIANCE_REFERENCE}\`.`,
|
|
135
136
|
"- **API contract** — when the partner's backend must be built or wrapped. Escalate: (1) the MCP",
|
|
136
137
|
' tool→call-sequence map (always); (2) "Recommended API Shapes" — concrete request/response JSON per',
|
|
137
138
|
' tool, including the hardest nested case; (3) a full OpenAPI spec for transactional apps. Contract',
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"skill-design-refs.js","sourceRoot":"","sources":["../src/skill-design-refs.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,qGAAqG;AACrG,gFAAgF;AAEhF,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,qBAAqB;QACrB,EAAE;QACF,gGAAgG;QAChG,iGAAiG;QACjG,iGAAiG;QACjG,6EAA6E;QAC7E,EAAE;QACF,aAAa;QACb,EAAE;QACF,gBAAgB;QAChB,8BAA8B;QAC9B,4BAA4B;QAC5B,sCAAsC;QACtC,0BAA0B;QAC1B,oCAAoC;QACpC,iCAAiC;QACjC,oBAAoB;QACpB,wBAAwB;QACxB,EAAE;QACF,iBAAiB;QACjB,EAAE;QACF,sGAAsG;QACtG,0CAA0C;QAC1C,EAAE;QACF,wGAAwG;QACxG,oFAAoF;QACpF,+FAA+F;QAC/F,mGAAmG;QACnG,uBAAuB;QACvB,qGAAqG;QACrG,wFAAwF;QACxF,8BAA8B;QAC9B,4FAA4F;QAC5F,EAAE;QACF,uGAAuG;QACvG,gDAAgD;QAChD,EAAE;QACF,+BAA+B;QAC/B,EAAE;QACF,oGAAoG;QACpG,wGAAwG;QACxG,oGAAoG;QACpG,uGAAuG;QACvG,kFAAkF;QAClF,EAAE;QACF,sGAAsG;QACtG,qGAAqG;QACrG,6CAA6C;QAC7C,EAAE;QACF,6BAA6B;QAC7B,EAAE;QACF,sGAAsG;QACtG,2FAA2F;QAC3F,uGAAuG;QACvG,qGAAqG;QACrG,qCAAqC;QACrC,EAAE;QACF,uCAAuC;QACvC,EAAE;QACF,uGAAuG;QACvG,mGAAmG;QACnG,wGAAwG;QACxG,uGAAuG;QACvG,yBAAyB;QACzB,EAAE;QACF,2BAA2B;QAC3B,EAAE;QACF,oGAAoG;QACpG,qGAAqG;QACrG,qGAAqG;QACrG,iGAAiG;QACjG,sGAAsG;QACtG,iDAAiD;QACjD,EAAE;QACF,qCAAqC;QACrC,EAAE;QACF,oGAAoG;QACpG,iGAAiG;QACjG,oGAAoG;QACpG,uEAAuE;QACvE,EAAE;QACF,kCAAkC;QAClC,EAAE;QACF,sGAAsG;QACtG,sGAAsG;QACtG,qGAAqG;QACrG,8FAA8F;QAC9F,sGAAsG;QACtG,wGAAwG;QACxG,uFAAuF;QACvF,qGAAqG;QACrG,EAAE;QACF,SAAS;QACT,qBAAqB;QACrB,oDAAoD;QACpD,wFAAwF;QACxF,qFAAqF;QACrF,yFAAyF;QACzF,uBAAuB;QACvB,iGAAiG;QACjG,8BAA8B;QAC9B,iGAAiG;QACjG,uGAAuG;QACvG,iGAAiG;QACjG,YAAY;QACZ,UAAU;QACV,QAAQ;QACR,KAAK;QACL,EAAE;QACF,oGAAoG;QACpG,4FAA4F;QAC5F,EAAE;QACF,gGAAgG;QAChG,qGAAqG;QACrG,qGAAqG;QACrG,4DAA4D;QAC5D,EAAE;QACF,qBAAqB;QACrB,EAAE;QACF,8FAA8F;QAC9F,+EAA+E;QAC/E,EAAE;QACF,qGAAqG;QACrG,qGAAqG;QACrG,iGAAiG;QACjG,uGAAuG;QACvG,6CAA6C;QAC7C,wGAAwG;QACxG,
|
|
1
|
+
{"version":3,"file":"skill-design-refs.js","sourceRoot":"","sources":["../src/skill-design-refs.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,qGAAqG;AACrG,gFAAgF;AAEhF,OAAO,EAAE,kCAAkC,EAAE,MAAM,mBAAmB,CAAC;AAEvE,MAAM,UAAU,+BAA+B;IAC7C,OAAO;QACL,qBAAqB;QACrB,EAAE;QACF,gGAAgG;QAChG,iGAAiG;QACjG,iGAAiG;QACjG,6EAA6E;QAC7E,EAAE;QACF,aAAa;QACb,EAAE;QACF,gBAAgB;QAChB,8BAA8B;QAC9B,4BAA4B;QAC5B,sCAAsC;QACtC,0BAA0B;QAC1B,oCAAoC;QACpC,iCAAiC;QACjC,oBAAoB;QACpB,wBAAwB;QACxB,EAAE;QACF,iBAAiB;QACjB,EAAE;QACF,sGAAsG;QACtG,0CAA0C;QAC1C,EAAE;QACF,wGAAwG;QACxG,oFAAoF;QACpF,+FAA+F;QAC/F,mGAAmG;QACnG,uBAAuB;QACvB,qGAAqG;QACrG,wFAAwF;QACxF,8BAA8B;QAC9B,4FAA4F;QAC5F,EAAE;QACF,uGAAuG;QACvG,gDAAgD;QAChD,EAAE;QACF,+BAA+B;QAC/B,EAAE;QACF,oGAAoG;QACpG,wGAAwG;QACxG,oGAAoG;QACpG,uGAAuG;QACvG,kFAAkF;QAClF,EAAE;QACF,sGAAsG;QACtG,qGAAqG;QACrG,6CAA6C;QAC7C,EAAE;QACF,6BAA6B;QAC7B,EAAE;QACF,sGAAsG;QACtG,2FAA2F;QAC3F,uGAAuG;QACvG,qGAAqG;QACrG,qCAAqC;QACrC,EAAE;QACF,uCAAuC;QACvC,EAAE;QACF,uGAAuG;QACvG,mGAAmG;QACnG,wGAAwG;QACxG,uGAAuG;QACvG,yBAAyB;QACzB,EAAE;QACF,2BAA2B;QAC3B,EAAE;QACF,oGAAoG;QACpG,qGAAqG;QACrG,qGAAqG;QACrG,iGAAiG;QACjG,sGAAsG;QACtG,iDAAiD;QACjD,EAAE;QACF,qCAAqC;QACrC,EAAE;QACF,oGAAoG;QACpG,iGAAiG;QACjG,oGAAoG;QACpG,uEAAuE;QACvE,EAAE;QACF,kCAAkC;QAClC,EAAE;QACF,sGAAsG;QACtG,sGAAsG;QACtG,qGAAqG;QACrG,8FAA8F;QAC9F,sGAAsG;QACtG,wGAAwG;QACxG,uFAAuF;QACvF,qGAAqG;QACrG,EAAE;QACF,SAAS;QACT,qBAAqB;QACrB,oDAAoD;QACpD,wFAAwF;QACxF,qFAAqF;QACrF,yFAAyF;QACzF,uBAAuB;QACvB,iGAAiG;QACjG,8BAA8B;QAC9B,iGAAiG;QACjG,uGAAuG;QACvG,iGAAiG;QACjG,YAAY;QACZ,UAAU;QACV,QAAQ;QACR,KAAK;QACL,EAAE;QACF,oGAAoG;QACpG,4FAA4F;QAC5F,EAAE;QACF,gGAAgG;QAChG,qGAAqG;QACrG,qGAAqG;QACrG,4DAA4D;QAC5D,EAAE;QACF,qBAAqB;QACrB,EAAE;QACF,8FAA8F;QAC9F,+EAA+E;QAC/E,EAAE;QACF,qGAAqG;QACrG,qGAAqG;QACrG,iGAAiG;QACjG,uGAAuG;QACvG,6CAA6C;QAC7C,wGAAwG;QACxG,kBAAkB,kCAAkC,KAAK;QACzD,iGAAiG;QACjG,sGAAsG;QACtG,qGAAqG;QACrG,qGAAqG;QACrG,mGAAmG;QACnG,iGAAiG;QACjG,yFAAyF;QACzF,EAAE;QACF,yBAAyB;QACzB,EAAE;QACF,uGAAuG;QACvG,qGAAqG;QACrG,uEAAuE;KACxE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
export declare function renderTestInHostsReference(): string;
|
|
2
2
|
export declare function renderTroubleshootingReference(): string;
|
|
3
|
+
export declare function renderInspectHostedReference(): string;
|
|
3
4
|
export declare function renderDeployAndOpsReference(): string;
|
|
4
5
|
export declare function renderPublishingReference(): string;
|
|
5
|
-
export declare function
|
|
6
|
+
export declare function renderAppDirectoryComplianceReference(): string;
|
|
6
7
|
//# sourceMappingURL=skill-operations-refs.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"skill-operations-refs.d.ts","sourceRoot":"","sources":["../src/skill-operations-refs.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"skill-operations-refs.d.ts","sourceRoot":"","sources":["../src/skill-operations-refs.ts"],"names":[],"mappings":"AAUA,wBAAgB,0BAA0B,IAAI,MAAM,CA0CnD;AAMD,wBAAgB,8BAA8B,IAAI,MAAM,CAgGvD;AAMD,wBAAgB,4BAA4B,IAAI,MAAM,CA6BrD;AAMD,wBAAgB,2BAA2B,IAAI,MAAM,CA4BpD;AAMD,wBAAgB,yBAAyB,IAAI,MAAM,CAgClD;AAMD,wBAAgB,qCAAqC,IAAI,MAAM,CA8D9D"}
|