@zackbart/connecta 0.12.1 → 0.12.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.
- package/CHANGELOG.md +36 -0
- package/dist/apps-shell.d.ts +13 -11
- package/dist/apps-shell.d.ts.map +1 -1
- package/dist/apps-shell.js +221 -30
- package/dist/apps-shell.js.map +1 -1
- package/dist/execute.d.ts +12 -4
- package/dist/execute.d.ts.map +1 -1
- package/dist/execute.js +131 -11
- package/dist/execute.js.map +1 -1
- package/dist/meta-tools.d.ts.map +1 -1
- package/dist/meta-tools.js +9 -0
- package/dist/meta-tools.js.map +1 -1
- package/dist/skills.d.ts +2 -2
- package/dist/skills.d.ts.map +1 -1
- package/dist/skills.js +3 -2
- package/dist/skills.js.map +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/documentation/code-mode.md +26 -14
- package/documentation/mcp-ui-design.md +8 -8
- package/documentation/program-ui-read-calls.md +213 -0
- package/ethos.md +2 -1
- package/package.json +1 -1
- package/src/apps-shell.ts +221 -30
- package/src/execute.ts +198 -12
- package/src/meta-tools.ts +9 -0
- package/src/skills.ts +3 -2
- package/src/version.ts +1 -1
- package/templates/node/package.json +1 -1
package/src/skills.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import type { Connector } from "./types.js";
|
|
2
2
|
|
|
3
3
|
export const CONNECTA_INSTRUCTIONS =
|
|
4
|
-
'Connecta exposes
|
|
4
|
+
'Connecta exposes seven meta-tools. execute_code is primary: use connecta.search, describe, call, and batch for discovery, multiple or dependent calls, loops, joins, and result reduction. connecta.ui(html) is a guest function inside execute_code, never a connector address or search_tools result; pass one HTML string for display-only, or bind named read-only refresh/drill-down calls in its optional reads argument, and return the same initial summary data the HTML renders. For one read at an unknown address, search_tools with 2–4 distinctive action/object terms and includeSchemas="compact", then one call_tool — a lone cold call is cheaper direct than a program. Use call_destructive_tool individually for unannotated, write-capable, or destructive tools; authorize_connector follows auth_required; get_result follows truncation. If this routing is unfamiliar, fetch skills({ name: "usage" }).';
|
|
5
5
|
|
|
6
6
|
export const USAGE_SKILL = `# Connecta usage
|
|
7
7
|
|
|
@@ -31,7 +31,8 @@ One async arrow function. The only capabilities are one global per connector (\`
|
|
|
31
31
|
|
|
32
32
|
## Rendering a view
|
|
33
33
|
|
|
34
|
-
\`connecta.ui(html)\` renders
|
|
34
|
+
\`connecta.ui(html)\` renders a display-only view on success for the client, never for the model. Fetch first, check the shape in code. On a surprise — empty array, missing key — return a trimmed first record instead of rendering: the wrong view becomes the sample you needed. Otherwise render from the variables you return; the model reads the return value, not the view.
|
|
35
|
+
|
|
35
36
|
`;
|
|
36
37
|
|
|
37
38
|
/**
|
package/src/version.ts
CHANGED