@fabric-harness/sdk 0.3.0 → 0.4.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/README.md +23 -17
- package/dist/agent-definition.d.ts +18 -1
- package/dist/agent-definition.d.ts.map +1 -1
- package/dist/agent-definition.js +23 -10
- package/dist/agent-definition.js.map +1 -1
- package/dist/cloudflare-source.d.ts +1 -1
- package/dist/cloudflare-source.js +1 -1
- package/dist/filesystem-source.d.ts +1 -1
- package/dist/filesystem-source.js +1 -1
- package/dist/index.d.ts +14 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +16 -1
- package/dist/index.js.map +1 -1
- package/dist/lite.d.ts +12 -44
- package/dist/lite.d.ts.map +1 -1
- package/dist/lite.js +12 -34
- package/dist/lite.js.map +1 -1
- package/dist/strict.d.ts +64 -0
- package/dist/strict.d.ts.map +1 -0
- package/dist/strict.js +43 -0
- package/dist/strict.js.map +1 -0
- package/dist/types.d.ts +4 -4
- package/package.json +5 -1
package/README.md
CHANGED
|
@@ -12,21 +12,24 @@ pnpm add @fabric-harness/sdk
|
|
|
12
12
|
|
|
13
13
|
## Quick start
|
|
14
14
|
|
|
15
|
-
###
|
|
15
|
+
### Minimal — bare import, headless defaults (8 lines)
|
|
16
16
|
|
|
17
17
|
```ts
|
|
18
|
-
import {
|
|
19
|
-
|
|
20
|
-
export default
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
},
|
|
18
|
+
import { agent } from '@fabric-harness/sdk';
|
|
19
|
+
|
|
20
|
+
export default agent<{ message: string }>({
|
|
21
|
+
name: 'echo',
|
|
22
|
+
triggers: { webhook: true },
|
|
23
|
+
run: async ({ init, input }) => {
|
|
24
|
+
const session = await (await init({ model: 'openai/gpt-5.5' })).session();
|
|
25
|
+
return { reply: await session.prompt<string>(input.message) };
|
|
26
|
+
},
|
|
27
|
+
});
|
|
27
28
|
```
|
|
28
29
|
|
|
29
|
-
###
|
|
30
|
+
### Complete — same import, more fields
|
|
31
|
+
|
|
32
|
+
### With typed I/O + capability policy + skills (same import)
|
|
30
33
|
|
|
31
34
|
```ts
|
|
32
35
|
import { agent, schema } from '@fabric-harness/sdk';
|
|
@@ -43,18 +46,21 @@ export default agent({
|
|
|
43
46
|
});
|
|
44
47
|
```
|
|
45
48
|
|
|
46
|
-
Both
|
|
49
|
+
Both forms share the same `init()`, `session.prompt()` / `skill()` / `task()` / `shell()` APIs. Runtime (`stateless`, `inline`, or `temporal`) is a separate choice configured at `init()`.
|
|
50
|
+
|
|
51
|
+
## One SDK, one import
|
|
52
|
+
|
|
53
|
+
`@fabric-harness/sdk` is the single import everyone uses. `agent({...})` from the bare import auto-injects headless defaults (`runtime: 'stateless'`, `sandbox: 'virtual'`, `loopRuntime: pi-agent-core`, `compaction: { enabled: true }`) on every `init()` call. Override any of them by passing values to `init()`. Add typed `input`/`output` schemas, `policy`, artifacts, custom stores, telemetry — they're all options on the same `agent({...})`/`init()` shape.
|
|
47
54
|
|
|
48
|
-
|
|
55
|
+
For Temporal-backed durable agents or compliance workloads where no implicit behaviour is wanted, use `@fabric-harness/sdk/strict` — same call shape, no defaults injected.
|
|
49
56
|
|
|
50
|
-
|
|
51
|
-
- **`@fabric-harness/sdk/lite`** — trimmed entry for headless / edge deployments. Same session primitives plus local/empty/remote sandbox helpers; smaller import graph.
|
|
57
|
+
Runtime (`stateless`, `inline`, or `temporal`) controls persistence and durability and is configured at `init()`. The deploy target (`node`, `temporal-worker`, `docker`, `cloudflare`, …) is chosen via `fh build --target`.
|
|
52
58
|
|
|
53
59
|
## What's in the box
|
|
54
60
|
|
|
55
61
|
- **`init({ model, sandbox, policy, runtime, ... })`** — initialize an agent runtime.
|
|
56
62
|
- **`session.prompt / skill / task / shell`** — the four agent operations.
|
|
57
|
-
- **`
|
|
63
|
+
- **`agent({...})`** — single builder. Same call shape from `/lite` and from the full SDK; the import you choose controls whether headless defaults are injected. `defineAgent(handler, options)` is kept as a backward-compat alias.
|
|
58
64
|
- **`defineCommand`** — bind a privileged CLI (`gh`, `npm`, …) with secrets at the command level, never in model context.
|
|
59
65
|
- **`withFilesystemSources`** — mount read-only content (knowledge base, runbooks) into the sandbox; the agent's built-in `grep` / `glob` / `read` tools see it as ordinary files.
|
|
60
66
|
- **`runtime: 'inline' | 'stateless' | 'temporal'`** — pick by persistence needs; the agent code is unchanged.
|
|
@@ -63,7 +69,7 @@ Both entrypoints share the same `init()`, `session.prompt()` / `skill()` / `task
|
|
|
63
69
|
|
|
64
70
|
## Documentation
|
|
65
71
|
|
|
66
|
-
- [Headless agents with the
|
|
72
|
+
- [Headless agents with the minimal entrypoint](https://harness.fabric.pro/docs/getting-started/headless-mode)
|
|
67
73
|
- [SDK entrypoints, runtimes, and targets](https://harness.fabric.pro/docs/reference/sdk-entrypoints-runtimes-targets)
|
|
68
74
|
- [Runtime modes](https://harness.fabric.pro/docs/reference/runtime-modes)
|
|
69
75
|
- [Filesystem sources](https://harness.fabric.pro/docs/reference/filesystem-sources)
|
|
@@ -59,7 +59,7 @@ export interface DefineAgentOptions {
|
|
|
59
59
|
* Pass `<TPayload>` to type the incoming `payload` without `as` casts:
|
|
60
60
|
*
|
|
61
61
|
* ```ts
|
|
62
|
-
* import { defineAgent } from '@fabric-harness/sdk
|
|
62
|
+
* import { defineAgent } from '@fabric-harness/sdk';
|
|
63
63
|
*
|
|
64
64
|
* export default defineAgent<{ message: string }>(async ({ init, payload }) => {
|
|
65
65
|
* const session = await (await init({ model: 'openai/gpt-5.5' })).session();
|
|
@@ -74,5 +74,22 @@ export interface DefineAgentOptions {
|
|
|
74
74
|
export declare function defineAgent<TPayload = unknown, TOutput = unknown>(handler: (context: FabricContext<TPayload> & {
|
|
75
75
|
input: TPayload;
|
|
76
76
|
}) => Promise<TOutput> | TOutput, options?: DefineAgentOptions): DefinedAgent<TPayload, TOutput>;
|
|
77
|
+
/**
|
|
78
|
+
* `agent({...})` — but exported from `@fabric-harness/sdk` so it
|
|
79
|
+
* automatically injects the headless defaults (stateless runtime, virtual
|
|
80
|
+
* sandbox, pi-agent-core loop, compaction-on) into every `init()` call.
|
|
81
|
+
*
|
|
82
|
+
* Same exact `AgentDefinition` shape as `agent()` from the full SDK — so
|
|
83
|
+
* users start with the lite import, and graduate to the full SDK by just
|
|
84
|
+
* swapping the import path. Existing field names (`name`, `input`, `output`,
|
|
85
|
+
* `triggers`, `run`) keep working identically. Add `input`/`output` schemas
|
|
86
|
+
* and `policy` once you're on the full SDK; they're allowed in lite too,
|
|
87
|
+
* they just don't unlock anything that isn't already in the lite surface.
|
|
88
|
+
*
|
|
89
|
+
* The function name is the same — `agent` — in both entry points to make
|
|
90
|
+
* the swap a one-line change. The lite default injection happens at runtime,
|
|
91
|
+
* not in the call shape.
|
|
92
|
+
*/
|
|
93
|
+
export declare function liteAgent<TInput = JsonObject, TOutput = unknown>(definition: AgentDefinition<TInput, TOutput>): DefinedAgent<TInput, TOutput>;
|
|
77
94
|
export {};
|
|
78
95
|
//# sourceMappingURL=agent-definition.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-definition.d.ts","sourceRoot":"","sources":["../src/agent-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,aAAa,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAc1C,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,GAAG,SAAS,CAAC;CACxD;AAED,MAAM,WAAW,eAAe,CAAC,MAAM,GAAG,UAAU,EAAE,OAAO,GAAG,OAAO;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC;IACpC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,GAAG,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACzF;AAED,QAAA,MAAM,gBAAgB,eAAgD,CAAC;AAEvE,MAAM,MAAM,YAAY,CAAC,MAAM,GAAG,UAAU,EAAE,OAAO,GAAG,OAAO,IAAI,CAAC,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG;IACpI,QAAQ,CAAC,CAAC,gBAAgB,CAAC,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9D,QAAQ,CAAC,aAAa,CAAC,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3D,CAAC;AAEF,wBAAgB,KAAK,CAAC,MAAM,GAAG,UAAU,EAAE,OAAO,GAAG,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzI;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,CAIhG;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC;IACpC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,WAAW,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAC/D,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,EAC/F,OAAO,GAAE,kBAAuB,GAC/B,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,
|
|
1
|
+
{"version":3,"file":"agent-definition.d.ts","sourceRoot":"","sources":["../src/agent-definition.ts"],"names":[],"mappings":"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"}
|
package/dist/agent-definition.js
CHANGED
|
@@ -59,7 +59,7 @@ export function getAgentDefinition(value) {
|
|
|
59
59
|
* Pass `<TPayload>` to type the incoming `payload` without `as` casts:
|
|
60
60
|
*
|
|
61
61
|
* ```ts
|
|
62
|
-
* import { defineAgent } from '@fabric-harness/sdk
|
|
62
|
+
* import { defineAgent } from '@fabric-harness/sdk';
|
|
63
63
|
*
|
|
64
64
|
* export default defineAgent<{ message: string }>(async ({ init, payload }) => {
|
|
65
65
|
* const session = await (await init({ model: 'openai/gpt-5.5' })).session();
|
|
@@ -72,10 +72,26 @@ export function getAgentDefinition(value) {
|
|
|
72
72
|
* builder keeps `runtime: 'inline'` as its default.
|
|
73
73
|
*/
|
|
74
74
|
export function defineAgent(handler, options = {}) {
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
75
|
+
return liteAgent({ ...options, run: handler });
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* `agent({...})` — but exported from `@fabric-harness/sdk` so it
|
|
79
|
+
* automatically injects the headless defaults (stateless runtime, virtual
|
|
80
|
+
* sandbox, pi-agent-core loop, compaction-on) into every `init()` call.
|
|
81
|
+
*
|
|
82
|
+
* Same exact `AgentDefinition` shape as `agent()` from the full SDK — so
|
|
83
|
+
* users start with the lite import, and graduate to the full SDK by just
|
|
84
|
+
* swapping the import path. Existing field names (`name`, `input`, `output`,
|
|
85
|
+
* `triggers`, `run`) keep working identically. Add `input`/`output` schemas
|
|
86
|
+
* and `policy` once you're on the full SDK; they're allowed in lite too,
|
|
87
|
+
* they just don't unlock anything that isn't already in the lite surface.
|
|
88
|
+
*
|
|
89
|
+
* The function name is the same — `agent` — in both entry points to make
|
|
90
|
+
* the swap a one-line change. The lite default injection happens at runtime,
|
|
91
|
+
* not in the call shape.
|
|
92
|
+
*/
|
|
93
|
+
export function liteAgent(definition) {
|
|
94
|
+
const wrappedRun = async (context) => {
|
|
79
95
|
const liteContext = {
|
|
80
96
|
...context,
|
|
81
97
|
init: async (init = {}) => context.init({
|
|
@@ -86,11 +102,8 @@ export function defineAgent(handler, options = {}) {
|
|
|
86
102
|
compaction: init.compaction ?? { enabled: true },
|
|
87
103
|
}),
|
|
88
104
|
};
|
|
89
|
-
return
|
|
105
|
+
return definition.run(liteContext);
|
|
90
106
|
};
|
|
91
|
-
return agent({
|
|
92
|
-
...options,
|
|
93
|
-
run: wrapped,
|
|
94
|
-
});
|
|
107
|
+
return agent({ ...definition, run: wrappedRun });
|
|
95
108
|
}
|
|
96
109
|
//# sourceMappingURL=agent-definition.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent-definition.js","sourceRoot":"","sources":["../src/agent-definition.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAEhE;;;;GAIG;AACH,IAAI,gBAAyE,CAAC;AAC9E,SAAS,kBAAkB;IACzB,IAAI,CAAC,gBAAgB;QAAE,gBAAgB,GAAG,wBAAwB,EAAE,CAAC;IACrE,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAqBD,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;AAOvE,MAAM,UAAU,KAAK,CAAyC,UAA4C;IACxG,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,OAAsB,EAAoB,EAAE;QAClE,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAiB,CAAC;QAChH,MAAM,cAAc,GAA8C;YAChE,GAAG,OAAO;YACV,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,WAAW;YAClB,IAAI,EAAE,KAAK,EAAE,UAAqB,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;gBACpD,GAAG,CAAC,UAAU,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACvF,GAAG,OAAO;gBACV,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnF,GAAG,CAAC,UAAU,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtH,CAAC;SACH,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACpD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3E,CAAC,CAA6C,CAAC;IAC/C,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3F,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1F,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IAClD,MAAM,SAAS,GAAG,KAAsH,CAAC;IACzI,OAAO,SAAS,CAAC,gBAAgB,CAAC,IAAI,SAAS,CAAC,aAAa,CAAC;AAChE,CAAC;AAeD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,WAAW,CACzB,OAA+F,EAC/F,UAA8B,EAAE;IAEhC,
|
|
1
|
+
{"version":3,"file":"agent-definition.js","sourceRoot":"","sources":["../src/agent-definition.ts"],"names":[],"mappings":"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"}
|
|
@@ -47,7 +47,7 @@ export interface R2FilesystemSourceOptions {
|
|
|
47
47
|
* sandbox tools.
|
|
48
48
|
*
|
|
49
49
|
* ```ts
|
|
50
|
-
* import { defineAgent, getVirtualSandbox } from '@fabric-harness/sdk
|
|
50
|
+
* import { defineAgent, getVirtualSandbox } from '@fabric-harness/sdk';
|
|
51
51
|
* import { r2FilesystemSource } from '@fabric-harness/sdk/cloudflare';
|
|
52
52
|
*
|
|
53
53
|
* export default defineAgent(async ({ init, payload, env }) => {
|
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
* sandbox tools.
|
|
14
14
|
*
|
|
15
15
|
* ```ts
|
|
16
|
-
* import { defineAgent, getVirtualSandbox } from '@fabric-harness/sdk
|
|
16
|
+
* import { defineAgent, getVirtualSandbox } from '@fabric-harness/sdk';
|
|
17
17
|
* import { r2FilesystemSource } from '@fabric-harness/sdk/cloudflare';
|
|
18
18
|
*
|
|
19
19
|
* export default defineAgent(async ({ init, payload, env }) => {
|
|
@@ -78,7 +78,7 @@ export declare function inMemorySource(files: Record<string, string | Uint8Array
|
|
|
78
78
|
* `grep`/`glob`/`read` tools.
|
|
79
79
|
*
|
|
80
80
|
* ```ts
|
|
81
|
-
* import { defineAgent, getVirtualSandbox, localDirectorySource } from '@fabric-harness/sdk
|
|
81
|
+
* import { defineAgent, getVirtualSandbox, localDirectorySource } from '@fabric-harness/sdk';
|
|
82
82
|
*
|
|
83
83
|
* export default defineAgent(async ({ init, payload }) => {
|
|
84
84
|
* const sandbox = getVirtualSandbox(localDirectorySource('./kb'));
|
|
@@ -89,7 +89,7 @@ export function inMemorySource(files, options = {}) {
|
|
|
89
89
|
* `grep`/`glob`/`read` tools.
|
|
90
90
|
*
|
|
91
91
|
* ```ts
|
|
92
|
-
* import { defineAgent, getVirtualSandbox, localDirectorySource } from '@fabric-harness/sdk
|
|
92
|
+
* import { defineAgent, getVirtualSandbox, localDirectorySource } from '@fabric-harness/sdk';
|
|
93
93
|
*
|
|
94
94
|
* export default defineAgent(async ({ init, payload }) => {
|
|
95
95
|
* const sandbox = getVirtualSandbox(localDirectorySource('./kb'));
|
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fabric-harness/sdk — the default entry point.
|
|
3
|
+
*
|
|
4
|
+
* `agent({...})` here applies headless defaults on every `init()` call —
|
|
5
|
+
* `runtime: 'stateless'`, `sandbox: 'virtual'`, `loopRuntime: pi-agent-core`,
|
|
6
|
+
* `compaction: { enabled: true }`. Override any of them by passing a value
|
|
7
|
+
* to `init()`. Smallest path from `npm install @fabric-harness/sdk` to a
|
|
8
|
+
* working agent.
|
|
9
|
+
*
|
|
10
|
+
* For Temporal-backed durable agents, compliance/audit, or any workload that
|
|
11
|
+
* wants no implicit behaviour, use the no-defaults variant from
|
|
12
|
+
* `@fabric-harness/sdk/strict` — same call shape, no defaults injected.
|
|
13
|
+
*/
|
|
1
14
|
export { init, StubFabricAgent } from './agent.js';
|
|
2
|
-
export { agent, defineAgent, getAgentDefinition } from './agent-definition.js';
|
|
15
|
+
export { liteAgent as agent, defineAgent, getAgentDefinition } from './agent-definition.js';
|
|
3
16
|
export { resolveRuntimeMode, isStatelessRuntime, isInMemoryStore } from './runtime-mode.js';
|
|
4
17
|
export { evaluateContextBudget, estimateModelMessagesTokens, estimateSessionEntriesTokens, estimateTextTokens, isContextOverflowError } from './context-budget.js';
|
|
5
18
|
export { createFabricContext } from './context.js';
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -1,5 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fabric-harness/sdk — the default entry point.
|
|
3
|
+
*
|
|
4
|
+
* `agent({...})` here applies headless defaults on every `init()` call —
|
|
5
|
+
* `runtime: 'stateless'`, `sandbox: 'virtual'`, `loopRuntime: pi-agent-core`,
|
|
6
|
+
* `compaction: { enabled: true }`. Override any of them by passing a value
|
|
7
|
+
* to `init()`. Smallest path from `npm install @fabric-harness/sdk` to a
|
|
8
|
+
* working agent.
|
|
9
|
+
*
|
|
10
|
+
* For Temporal-backed durable agents, compliance/audit, or any workload that
|
|
11
|
+
* wants no implicit behaviour, use the no-defaults variant from
|
|
12
|
+
* `@fabric-harness/sdk/strict` — same call shape, no defaults injected.
|
|
13
|
+
*/
|
|
1
14
|
export { init, StubFabricAgent } from './agent.js';
|
|
2
|
-
|
|
15
|
+
// `liteAgent` (re-exported as `agent`) injects the headless defaults at runtime.
|
|
16
|
+
// `defineAgent` is kept as a backward-compat handler-first alias.
|
|
17
|
+
export { liteAgent as agent, defineAgent, getAgentDefinition } from './agent-definition.js';
|
|
3
18
|
export { resolveRuntimeMode, isStatelessRuntime, isInMemoryStore } from './runtime-mode.js';
|
|
4
19
|
export { evaluateContextBudget, estimateModelMessagesTokens, estimateSessionEntriesTokens, estimateTextTokens, isContextOverflowError } from './context-budget.js';
|
|
5
20
|
export { createFabricContext } from './context.js';
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/lite.d.ts
CHANGED
|
@@ -1,51 +1,19 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @fabric-harness/sdk/lite —
|
|
2
|
+
* @fabric-harness/sdk/lite — DEPRECATED alias for `@fabric-harness/sdk`.
|
|
3
3
|
*
|
|
4
|
-
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
* the import graph. Use this when bundling for Cloudflare Workers, Vercel
|
|
8
|
-
* Edge, AWS Lambda, or any environment where you want the smallest
|
|
9
|
-
* possible import footprint.
|
|
4
|
+
* Starting in 0.4.0 the bare `@fabric-harness/sdk` import IS the
|
|
5
|
+
* headless-defaults variant. The `/lite` subpath stays for one minor so
|
|
6
|
+
* existing 0.3.x code keeps building. Migrate at your convenience:
|
|
10
7
|
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
13
|
-
* `@fabric-harness/sdk` directly.
|
|
8
|
+
* import { agent } from '@fabric-harness/sdk/lite'; // before (deprecated)
|
|
9
|
+
* import { agent } from '@fabric-harness/sdk'; // after
|
|
14
10
|
*
|
|
15
|
-
*
|
|
16
|
-
*
|
|
11
|
+
* The export surface is identical to `@fabric-harness/sdk`. No behaviour
|
|
12
|
+
* change — `agent({...})` from this path is the same function as
|
|
13
|
+
* `agent({...})` from the bare path.
|
|
17
14
|
*
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
* model: 'openai/gpt-5.5',
|
|
21
|
-
* runtime: 'stateless',
|
|
22
|
-
* })).session();
|
|
23
|
-
* return { reply: (await session.prompt(String(payload?.message ?? ''))).text };
|
|
24
|
-
* });
|
|
25
|
-
* ```
|
|
15
|
+
* For the no-defaults variant (Temporal / compliance / production), use
|
|
16
|
+
* `@fabric-harness/sdk/strict`.
|
|
26
17
|
*/
|
|
27
|
-
export
|
|
28
|
-
export { agent, defineAgent, getAgentDefinition } from './agent-definition.js';
|
|
29
|
-
export { createFabricContext } from './context.js';
|
|
30
|
-
export { FabricError, isFabricError, toFabricError } from './error.js';
|
|
31
|
-
export { schema, SchemaValidationError } from './schema.js';
|
|
32
|
-
export { isEvent } from './events.js';
|
|
33
|
-
export type { AgentEvent, AgentEventBase, AgentEventCallback, AgentEventType } from './events.js';
|
|
34
|
-
export { createBuiltinTools, defineCommand, defineTool, secret, shellQuote } from './tools.js';
|
|
35
|
-
export { createRemoteSandboxEnv, createSandboxEnv, createScopedSandboxEnv, EmptySandboxEnv, LocalSandboxEnv } from './sandbox.js';
|
|
36
|
-
export { VirtualSandboxEnv, createVirtualSandboxEnv } from './virtual-sandbox.js';
|
|
37
|
-
export { fumadocsSource, getVirtualSandbox, httpFilesystemSource, inMemorySource, localDirectorySource, mintlifySource, withFilesystemSources } from './filesystem-source.js';
|
|
38
|
-
export type { FilesystemEntry, FilesystemSource, HttpResource, MountedSource } from './filesystem-source.js';
|
|
39
|
-
export { resolveRuntimeMode, isStatelessRuntime } from './runtime-mode.js';
|
|
40
|
-
export { PiAgentLoopRuntime, createPiAgentLoopRuntime } from './pi-loop-runtime.js';
|
|
41
|
-
export type { PiAgentLoopRuntimeOptions, PiCustomModel } from './pi-loop-runtime.js';
|
|
42
|
-
export { noopSessionStore, NoopSessionStore } from './store.js';
|
|
43
|
-
export { connectMcpServer } from './mcp.js';
|
|
44
|
-
export type { AgentDefinition, AgentTriggers, DefineAgentOptions, DefinedAgent } from './agent-definition.js';
|
|
45
|
-
export type { Schema, SchemaIssue, JsonSchemaObject } from './schema.js';
|
|
46
|
-
export type { Command, CommandEnvValue, SecretRef, ToolDef, } from './tools.js';
|
|
47
|
-
export type { AgentInit, FabricAgent, FabricContext, FabricRuntime, JsonObject, JsonValue, PromptOptions, Role, SandboxBackend, SessionOptions, ShellOptions, ShellResult, Skill, SkillOptions, } from './types.js';
|
|
48
|
-
export type { FabricSession } from './session.js';
|
|
49
|
-
export type { RemoteSandboxApi, RemoteSandboxOptions, SandboxEnv, SandboxExecOptions, SandboxFactory, SandboxFactoryOptions } from './sandbox.js';
|
|
50
|
-
export type { ModelConfig, ProviderSettings, ProvidersConfig } from './providers.js';
|
|
18
|
+
export * from './index.js';
|
|
51
19
|
//# sourceMappingURL=lite.d.ts.map
|
package/dist/lite.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lite.d.ts","sourceRoot":"","sources":["../src/lite.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"lite.d.ts","sourceRoot":"","sources":["../src/lite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,YAAY,CAAC"}
|
package/dist/lite.js
CHANGED
|
@@ -1,41 +1,19 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @fabric-harness/sdk/lite —
|
|
2
|
+
* @fabric-harness/sdk/lite — DEPRECATED alias for `@fabric-harness/sdk`.
|
|
3
3
|
*
|
|
4
|
-
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
* the import graph. Use this when bundling for Cloudflare Workers, Vercel
|
|
8
|
-
* Edge, AWS Lambda, or any environment where you want the smallest
|
|
9
|
-
* possible import footprint.
|
|
4
|
+
* Starting in 0.4.0 the bare `@fabric-harness/sdk` import IS the
|
|
5
|
+
* headless-defaults variant. The `/lite` subpath stays for one minor so
|
|
6
|
+
* existing 0.3.x code keeps building. Migrate at your convenience:
|
|
10
7
|
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
13
|
-
* `@fabric-harness/sdk` directly.
|
|
8
|
+
* import { agent } from '@fabric-harness/sdk/lite'; // before (deprecated)
|
|
9
|
+
* import { agent } from '@fabric-harness/sdk'; // after
|
|
14
10
|
*
|
|
15
|
-
*
|
|
16
|
-
*
|
|
11
|
+
* The export surface is identical to `@fabric-harness/sdk`. No behaviour
|
|
12
|
+
* change — `agent({...})` from this path is the same function as
|
|
13
|
+
* `agent({...})` from the bare path.
|
|
17
14
|
*
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
* model: 'openai/gpt-5.5',
|
|
21
|
-
* runtime: 'stateless',
|
|
22
|
-
* })).session();
|
|
23
|
-
* return { reply: (await session.prompt(String(payload?.message ?? ''))).text };
|
|
24
|
-
* });
|
|
25
|
-
* ```
|
|
15
|
+
* For the no-defaults variant (Temporal / compliance / production), use
|
|
16
|
+
* `@fabric-harness/sdk/strict`.
|
|
26
17
|
*/
|
|
27
|
-
export
|
|
28
|
-
export { agent, defineAgent, getAgentDefinition } from './agent-definition.js';
|
|
29
|
-
export { createFabricContext } from './context.js';
|
|
30
|
-
export { FabricError, isFabricError, toFabricError } from './error.js';
|
|
31
|
-
export { schema, SchemaValidationError } from './schema.js';
|
|
32
|
-
export { isEvent } from './events.js';
|
|
33
|
-
export { createBuiltinTools, defineCommand, defineTool, secret, shellQuote } from './tools.js';
|
|
34
|
-
export { createRemoteSandboxEnv, createSandboxEnv, createScopedSandboxEnv, EmptySandboxEnv, LocalSandboxEnv } from './sandbox.js';
|
|
35
|
-
export { VirtualSandboxEnv, createVirtualSandboxEnv } from './virtual-sandbox.js';
|
|
36
|
-
export { fumadocsSource, getVirtualSandbox, httpFilesystemSource, inMemorySource, localDirectorySource, mintlifySource, withFilesystemSources } from './filesystem-source.js';
|
|
37
|
-
export { resolveRuntimeMode, isStatelessRuntime } from './runtime-mode.js';
|
|
38
|
-
export { PiAgentLoopRuntime, createPiAgentLoopRuntime } from './pi-loop-runtime.js';
|
|
39
|
-
export { noopSessionStore, NoopSessionStore } from './store.js';
|
|
40
|
-
export { connectMcpServer } from './mcp.js';
|
|
18
|
+
export * from './index.js';
|
|
41
19
|
//# sourceMappingURL=lite.js.map
|
package/dist/lite.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lite.js","sourceRoot":"","sources":["../src/lite.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"lite.js","sourceRoot":"","sources":["../src/lite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,cAAc,YAAY,CAAC"}
|
package/dist/strict.d.ts
ADDED
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fabric-harness/sdk/strict — fully explicit, no-defaults entry point.
|
|
3
|
+
*
|
|
4
|
+
* Same exports as `@fabric-harness/sdk` (bare). The only difference is that
|
|
5
|
+
* `agent({...})` does NOT auto-inject any of the headless defaults
|
|
6
|
+
* (`runtime`, `sandbox`, `loopRuntime`, `compaction`). Every option must
|
|
7
|
+
* be declared in source — useful for:
|
|
8
|
+
*
|
|
9
|
+
* - Temporal-backed durable agents (replay determinism).
|
|
10
|
+
* - Compliance / audit / regulated workloads.
|
|
11
|
+
* - Production agents that prefer explicitness over defaults.
|
|
12
|
+
*
|
|
13
|
+
* For the friendly default experience, import from `@fabric-harness/sdk`
|
|
14
|
+
* directly — same call shape, defaults injected when you don't override.
|
|
15
|
+
*/
|
|
16
|
+
export { init, StubFabricAgent } from './agent.js';
|
|
17
|
+
export { agent, defineAgent, getAgentDefinition } from './agent-definition.js';
|
|
18
|
+
export { resolveRuntimeMode, isStatelessRuntime, isInMemoryStore } from './runtime-mode.js';
|
|
19
|
+
export { evaluateContextBudget, estimateModelMessagesTokens, estimateSessionEntriesTokens, estimateTextTokens, isContextOverflowError } from './context-budget.js';
|
|
20
|
+
export { createFabricContext } from './context.js';
|
|
21
|
+
export { FabricError, isFabricError, toFabricError } from './error.js';
|
|
22
|
+
export { redactError, redactJson, redactText } from './redaction.js';
|
|
23
|
+
export { DEFAULT_HEADLESS_PREAMBLE, SessionHistory, buildModelMessagesFromHistory } from './history.js';
|
|
24
|
+
export { NativeLoopRuntime, defaultLoopRuntime } from './loop.js';
|
|
25
|
+
export { PiAgentLoopRuntime, createPiAgentLoopRuntime } from './pi-loop-runtime.js';
|
|
26
|
+
export type { PiAgentLoopRuntimeOptions, PiCustomModel } from './pi-loop-runtime.js';
|
|
27
|
+
export { connectMcpServer, createMcpTools } from './mcp.js';
|
|
28
|
+
export { StdioMcpClient, createStdioMcpClient } from './mcp-stdio.js';
|
|
29
|
+
export { AnthropicModelProvider, AzureOpenAIModelProvider, BedrockModelProvider, CohereModelProvider, FallbackModelProvider, GeminiModelProvider, MockModelProvider, OpenAICompatibleModelProvider, ProviderHttpError, VertexAIModelProvider, defaultModelProvider, generateWithRuntime, toolsToModelSchemas, } from './model.js';
|
|
30
|
+
export { clampCommandTimeout, evaluateCommandPolicy, evaluateToolCallPolicy, } from './policy.js';
|
|
31
|
+
export { parseModelRef, resolveModelProvider } from './providers.js';
|
|
32
|
+
export { RESULT_END_DELIMITER, RESULT_START_DELIMITER, buildResultRetryPrompt, extractResultValue, validateResult } from './result.js';
|
|
33
|
+
export { StubFabricSession } from './session.js';
|
|
34
|
+
export { createRemoteSandboxEnv, createSandboxEnv, createScopedSandboxEnv, DockerSandboxEnv, EmptySandboxEnv, LocalSandboxEnv, UnimplementedSandboxEnv } from './sandbox.js';
|
|
35
|
+
export { VirtualSandboxEnv, createVirtualSandboxEnv } from './virtual-sandbox.js';
|
|
36
|
+
export { fumadocsSource, getVirtualSandbox, httpFilesystemSource, inMemorySource, localDirectorySource, mintlifySource, withFilesystemSources } from './filesystem-source.js';
|
|
37
|
+
export type { FilesystemEntry, FilesystemSource, HttpResource, MountedSource } from './filesystem-source.js';
|
|
38
|
+
export { SchemaValidationError, formatSchemaIssues, schema } from './schema.js';
|
|
39
|
+
export { isEvent } from './events.js';
|
|
40
|
+
export type { AgentEvent, AgentEventBase, AgentEventCallback, AgentEventType } from './events.js';
|
|
41
|
+
export { emitOpenTelemetrySpan, openTelemetryExporter } from './otel.js';
|
|
42
|
+
export { consoleTelemetryExporter, entryToTelemetrySpan, eventToTelemetrySpan } from './telemetry.js';
|
|
43
|
+
export { InMemorySessionStore, NoopSessionStore, approvalStatesFromEntries, defaultSessionStore, noopSessionStore } from './store.js';
|
|
44
|
+
export { bashTool, createBuiltinTools, createCommandTools, createFileTools, defineCommand, defineTool, editFileTool, existsTool, globTool, grepTool, mkdirTool, readFileBufferTool, readFileTool, readdirTool, rmTool, secret, shellQuote, statTool, writeFileTool, } from './tools.js';
|
|
45
|
+
export type { ContextBudget, ContextBudgetOptions } from './context-budget.js';
|
|
46
|
+
export type { FabricErrorCode, FabricErrorOptions } from './error.js';
|
|
47
|
+
export type { RedactionOptions } from './redaction.js';
|
|
48
|
+
export type { ApprovalRisk, CapabilityPolicy, CommandPolicy, FilesystemPolicy, PolicyDecision, ToolPolicy } from './policy.js';
|
|
49
|
+
export type { ModelConfig, ParsedModelRef, ProviderSettings, ProvidersConfig, ResolveModelProviderOptions, ResolvedModelProvider } from './providers.js';
|
|
50
|
+
export type { AgentDefinition, AgentTriggers, DefineAgentOptions, DefinedAgent } from './agent-definition.js';
|
|
51
|
+
export type { RuntimeModeResolution } from './runtime-mode.js';
|
|
52
|
+
export type { JsonSchemaObject, Schema, SchemaIssue } from './schema.js';
|
|
53
|
+
export type { AgentLoopRuntime, PromptRunInput, PromptRunResult, } from './loop.js';
|
|
54
|
+
export type { CreateMcpToolsOptions, McpClientLike, McpServerConnection, McpServerOptions, McpToolDescriptor, McpTransport } from './mcp.js';
|
|
55
|
+
export type { OpenTelemetryExporterOptions } from './otel.js';
|
|
56
|
+
export type { TelemetryExporter, TelemetrySpan } from './telemetry.js';
|
|
57
|
+
export type { StdioMcpClientOptions } from './mcp-stdio.js';
|
|
58
|
+
export type { ModelAttemptEvent, ModelMessage, ModelMessageRole, ModelProvider, ModelRequest, ModelResponse, ModelRuntimeOptions, ModelToolCall, ModelToolSchema, ModelUsage, AnthropicProviderOptions, AzureOpenAIProviderOptions, BedrockProviderOptions, CohereProviderOptions, FallbackModelProviderOptions, GeminiProviderOptions, OpenAICompatibleProviderOptions, VertexAIProviderOptions, } from './model.js';
|
|
59
|
+
export type { FabricSession } from './session.js';
|
|
60
|
+
export { pruneSnapshots } from './sandbox.js';
|
|
61
|
+
export type { DockerSandboxOptions, FileStat, LocalSandboxOptions, RemoteSandboxApi, RemoteSandboxOptions, SandboxAdapterDescriptor, SandboxCapabilities, SandboxEnv, SandboxExecOptions, SandboxFactory, SandboxFactoryOptions, SandboxSnapshot, SnapshotPruneOptions, SnapshotPruneResult, } from './sandbox.js';
|
|
62
|
+
export type { ActorIdentity, AgentInit, ApprovalCallback, ApprovalDecision, ApprovalOptions, ApprovalRequest, ApprovalResponse, ApprovalState, ApprovalStateStatus, ApprovalUnavailableStrategy, ApprovalVote, ArtifactCreateOptions, ArtifactRef, AutonomyMode, AutonomyOptions, CheckpointCreateOptions, CheckpointRestoreOptions, CheckpointResult, CompactionOptions, CompactionResult, FabricActor, FabricAgent, FabricContext, FabricEvent, FabricEventCallback, FabricEventType, FabricRuntime, JsonObject, JsonPrimitive, JsonValue, CredentialMissingStrategy, MissingInputStrategy, PromptOptions, ResultExtractionOptions, ResultValidator, Role, SandboxBackend, SessionData, SessionEntry, SessionEntryType, SessionOptions, SessionStore, ShellOptions, ShellResult, Skill, SkillOptions, TaskOptions, } from './types.js';
|
|
63
|
+
export type { BashInput, BuiltinFileTool, BuiltinTool, Command, CommandEnvValue, CommandToolInput, CommandToolOptions, EditInput, ExistsInput, GlobInput, GrepInput, GrepMatch, MkdirInput, ReadFileBufferInput, ReadFileInput, ReaddirInput, RmInput, SecretRef, StatInput, ToolCall, ToolCallResult, ToolContext, ToolDef, ToolEffect, WriteFileInput, } from './tools.js';
|
|
64
|
+
//# sourceMappingURL=strict.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"strict.d.ts","sourceRoot":"","sources":["../src/strict.ts"],"names":[],"mappings":"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"}
|
package/dist/strict.js
ADDED
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fabric-harness/sdk/strict — fully explicit, no-defaults entry point.
|
|
3
|
+
*
|
|
4
|
+
* Same exports as `@fabric-harness/sdk` (bare). The only difference is that
|
|
5
|
+
* `agent({...})` does NOT auto-inject any of the headless defaults
|
|
6
|
+
* (`runtime`, `sandbox`, `loopRuntime`, `compaction`). Every option must
|
|
7
|
+
* be declared in source — useful for:
|
|
8
|
+
*
|
|
9
|
+
* - Temporal-backed durable agents (replay determinism).
|
|
10
|
+
* - Compliance / audit / regulated workloads.
|
|
11
|
+
* - Production agents that prefer explicitness over defaults.
|
|
12
|
+
*
|
|
13
|
+
* For the friendly default experience, import from `@fabric-harness/sdk`
|
|
14
|
+
* directly — same call shape, defaults injected when you don't override.
|
|
15
|
+
*/
|
|
16
|
+
export { init, StubFabricAgent } from './agent.js';
|
|
17
|
+
export { agent, defineAgent, getAgentDefinition } from './agent-definition.js';
|
|
18
|
+
export { resolveRuntimeMode, isStatelessRuntime, isInMemoryStore } from './runtime-mode.js';
|
|
19
|
+
export { evaluateContextBudget, estimateModelMessagesTokens, estimateSessionEntriesTokens, estimateTextTokens, isContextOverflowError } from './context-budget.js';
|
|
20
|
+
export { createFabricContext } from './context.js';
|
|
21
|
+
export { FabricError, isFabricError, toFabricError } from './error.js';
|
|
22
|
+
export { redactError, redactJson, redactText } from './redaction.js';
|
|
23
|
+
export { DEFAULT_HEADLESS_PREAMBLE, SessionHistory, buildModelMessagesFromHistory } from './history.js';
|
|
24
|
+
export { NativeLoopRuntime, defaultLoopRuntime } from './loop.js';
|
|
25
|
+
export { PiAgentLoopRuntime, createPiAgentLoopRuntime } from './pi-loop-runtime.js';
|
|
26
|
+
export { connectMcpServer, createMcpTools } from './mcp.js';
|
|
27
|
+
export { StdioMcpClient, createStdioMcpClient } from './mcp-stdio.js';
|
|
28
|
+
export { AnthropicModelProvider, AzureOpenAIModelProvider, BedrockModelProvider, CohereModelProvider, FallbackModelProvider, GeminiModelProvider, MockModelProvider, OpenAICompatibleModelProvider, ProviderHttpError, VertexAIModelProvider, defaultModelProvider, generateWithRuntime, toolsToModelSchemas, } from './model.js';
|
|
29
|
+
export { clampCommandTimeout, evaluateCommandPolicy, evaluateToolCallPolicy, } from './policy.js';
|
|
30
|
+
export { parseModelRef, resolveModelProvider } from './providers.js';
|
|
31
|
+
export { RESULT_END_DELIMITER, RESULT_START_DELIMITER, buildResultRetryPrompt, extractResultValue, validateResult } from './result.js';
|
|
32
|
+
export { StubFabricSession } from './session.js';
|
|
33
|
+
export { createRemoteSandboxEnv, createSandboxEnv, createScopedSandboxEnv, DockerSandboxEnv, EmptySandboxEnv, LocalSandboxEnv, UnimplementedSandboxEnv } from './sandbox.js';
|
|
34
|
+
export { VirtualSandboxEnv, createVirtualSandboxEnv } from './virtual-sandbox.js';
|
|
35
|
+
export { fumadocsSource, getVirtualSandbox, httpFilesystemSource, inMemorySource, localDirectorySource, mintlifySource, withFilesystemSources } from './filesystem-source.js';
|
|
36
|
+
export { SchemaValidationError, formatSchemaIssues, schema } from './schema.js';
|
|
37
|
+
export { isEvent } from './events.js';
|
|
38
|
+
export { emitOpenTelemetrySpan, openTelemetryExporter } from './otel.js';
|
|
39
|
+
export { consoleTelemetryExporter, entryToTelemetrySpan, eventToTelemetrySpan } from './telemetry.js';
|
|
40
|
+
export { InMemorySessionStore, NoopSessionStore, approvalStatesFromEntries, defaultSessionStore, noopSessionStore } from './store.js';
|
|
41
|
+
export { bashTool, createBuiltinTools, createCommandTools, createFileTools, defineCommand, defineTool, editFileTool, existsTool, globTool, grepTool, mkdirTool, readFileBufferTool, readFileTool, readdirTool, rmTool, secret, shellQuote, statTool, writeFileTool, } from './tools.js';
|
|
42
|
+
export { pruneSnapshots } from './sandbox.js';
|
|
43
|
+
//# sourceMappingURL=strict.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"strict.js","sourceRoot":"","sources":["../src/strict.ts"],"names":[],"mappings":"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"}
|
package/dist/types.d.ts
CHANGED
|
@@ -95,10 +95,10 @@ export interface AgentInit {
|
|
|
95
95
|
*
|
|
96
96
|
* Merged at prompt time with any per-call overrides on `PromptOptions`.
|
|
97
97
|
*
|
|
98
|
-
* - **
|
|
99
|
-
* don't fail at the context-window boundary.
|
|
100
|
-
* - **
|
|
101
|
-
* typically want deterministic context handling and explicit compaction
|
|
98
|
+
* - **Minimal entrypoint / headless shorthand** (`defineAgent`) defaults
|
|
99
|
+
* `enabled: true` so long sessions don't fail at the context-window boundary.
|
|
100
|
+
* - **Complete metadata agents** (`agent({...})`) default to off — production
|
|
101
|
+
* agents typically want deterministic context handling and explicit compaction
|
|
102
102
|
* behaviour. Opt in by setting `init({ compaction: { enabled: true } })`.
|
|
103
103
|
*/
|
|
104
104
|
export interface CompactionSettings {
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fabric-harness/sdk",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "Headless TypeScript framework for building durable, deployable autonomous agents — core SDK.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"author": "Fabric",
|
|
@@ -41,6 +41,10 @@
|
|
|
41
41
|
"types": "./dist/lite.d.ts",
|
|
42
42
|
"import": "./dist/lite.js"
|
|
43
43
|
},
|
|
44
|
+
"./strict": {
|
|
45
|
+
"types": "./dist/strict.d.ts",
|
|
46
|
+
"import": "./dist/strict.js"
|
|
47
|
+
},
|
|
44
48
|
"./cloudflare": {
|
|
45
49
|
"types": "./dist/cloudflare-source.d.ts",
|
|
46
50
|
"import": "./dist/cloudflare-source.js"
|