@some-useful-agents/core 0.1.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.
Files changed (69) hide show
  1. package/dist/agent-executor.d.ts +12 -0
  2. package/dist/agent-executor.d.ts.map +1 -0
  3. package/dist/agent-executor.js +121 -0
  4. package/dist/agent-executor.js.map +1 -0
  5. package/dist/agent-loader.d.ts +19 -0
  6. package/dist/agent-loader.d.ts.map +1 -0
  7. package/dist/agent-loader.js +76 -0
  8. package/dist/agent-loader.js.map +1 -0
  9. package/dist/agent-loader.test.d.ts +2 -0
  10. package/dist/agent-loader.test.d.ts.map +1 -0
  11. package/dist/agent-loader.test.js +82 -0
  12. package/dist/agent-loader.test.js.map +1 -0
  13. package/dist/chain-executor.d.ts +16 -0
  14. package/dist/chain-executor.d.ts.map +1 -0
  15. package/dist/chain-executor.js +54 -0
  16. package/dist/chain-executor.js.map +1 -0
  17. package/dist/chain-resolver.d.ts +27 -0
  18. package/dist/chain-resolver.d.ts.map +1 -0
  19. package/dist/chain-resolver.js +82 -0
  20. package/dist/chain-resolver.js.map +1 -0
  21. package/dist/chain-resolver.test.d.ts +2 -0
  22. package/dist/chain-resolver.test.d.ts.map +1 -0
  23. package/dist/chain-resolver.test.js +86 -0
  24. package/dist/chain-resolver.test.js.map +1 -0
  25. package/dist/env-builder.d.ts +16 -0
  26. package/dist/env-builder.d.ts.map +1 -0
  27. package/dist/env-builder.js +59 -0
  28. package/dist/env-builder.js.map +1 -0
  29. package/dist/env-builder.test.d.ts +2 -0
  30. package/dist/env-builder.test.d.ts.map +1 -0
  31. package/dist/env-builder.test.js +167 -0
  32. package/dist/env-builder.test.js.map +1 -0
  33. package/dist/index.d.ts +11 -0
  34. package/dist/index.d.ts.map +1 -0
  35. package/dist/index.js +11 -0
  36. package/dist/index.js.map +1 -0
  37. package/dist/local-provider.d.ts +24 -0
  38. package/dist/local-provider.d.ts.map +1 -0
  39. package/dist/local-provider.js +101 -0
  40. package/dist/local-provider.js.map +1 -0
  41. package/dist/run-store.d.ts +16 -0
  42. package/dist/run-store.d.ts.map +1 -0
  43. package/dist/run-store.js +115 -0
  44. package/dist/run-store.js.map +1 -0
  45. package/dist/run-store.test.d.ts +2 -0
  46. package/dist/run-store.test.d.ts.map +1 -0
  47. package/dist/run-store.test.js +83 -0
  48. package/dist/run-store.test.js.map +1 -0
  49. package/dist/schema.d.ts +104 -0
  50. package/dist/schema.d.ts.map +1 -0
  51. package/dist/schema.js +35 -0
  52. package/dist/schema.js.map +1 -0
  53. package/dist/schema.test.d.ts +2 -0
  54. package/dist/schema.test.d.ts.map +1 -0
  55. package/dist/schema.test.js +108 -0
  56. package/dist/schema.test.js.map +1 -0
  57. package/dist/secrets-store.d.ts +34 -0
  58. package/dist/secrets-store.d.ts.map +1 -0
  59. package/dist/secrets-store.js +116 -0
  60. package/dist/secrets-store.js.map +1 -0
  61. package/dist/secrets-store.test.d.ts +2 -0
  62. package/dist/secrets-store.test.d.ts.map +1 -0
  63. package/dist/secrets-store.test.js +99 -0
  64. package/dist/secrets-store.test.js.map +1 -0
  65. package/dist/types.d.ts +52 -0
  66. package/dist/types.d.ts.map +1 -0
  67. package/dist/types.js +2 -0
  68. package/dist/types.js.map +1 -0
  69. package/package.json +30 -0
@@ -0,0 +1,86 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import { resolveExecutionOrder, resolveTemplate, CycleError, MissingDependencyError } from './chain-resolver.js';
3
+ function agent(name, deps) {
4
+ return { name, type: 'shell', command: `echo ${name}`, dependsOn: deps };
5
+ }
6
+ describe('resolveExecutionOrder', () => {
7
+ it('returns single agent with no dependencies', () => {
8
+ const agents = new Map([['a', agent('a')]]);
9
+ const order = resolveExecutionOrder(agents);
10
+ expect(order.map(a => a.name)).toEqual(['a']);
11
+ });
12
+ it('resolves linear dependency chain', () => {
13
+ const agents = new Map([
14
+ ['c', agent('c', ['b'])],
15
+ ['b', agent('b', ['a'])],
16
+ ['a', agent('a')],
17
+ ]);
18
+ const order = resolveExecutionOrder(agents);
19
+ const names = order.map(a => a.name);
20
+ expect(names.indexOf('a')).toBeLessThan(names.indexOf('b'));
21
+ expect(names.indexOf('b')).toBeLessThan(names.indexOf('c'));
22
+ });
23
+ it('resolves diamond dependency', () => {
24
+ const agents = new Map([
25
+ ['d', agent('d', ['b', 'c'])],
26
+ ['b', agent('b', ['a'])],
27
+ ['c', agent('c', ['a'])],
28
+ ['a', agent('a')],
29
+ ]);
30
+ const order = resolveExecutionOrder(agents);
31
+ const names = order.map(a => a.name);
32
+ expect(names.indexOf('a')).toBeLessThan(names.indexOf('b'));
33
+ expect(names.indexOf('a')).toBeLessThan(names.indexOf('c'));
34
+ expect(names.indexOf('b')).toBeLessThan(names.indexOf('d'));
35
+ expect(names.indexOf('c')).toBeLessThan(names.indexOf('d'));
36
+ });
37
+ it('throws CycleError on circular dependency', () => {
38
+ const agents = new Map([
39
+ ['a', agent('a', ['b'])],
40
+ ['b', agent('b', ['a'])],
41
+ ]);
42
+ expect(() => resolveExecutionOrder(agents)).toThrow(CycleError);
43
+ });
44
+ it('throws CycleError on self-reference', () => {
45
+ const agents = new Map([['a', agent('a', ['a'])]]);
46
+ expect(() => resolveExecutionOrder(agents)).toThrow(CycleError);
47
+ });
48
+ it('throws MissingDependencyError for nonexistent dependency', () => {
49
+ const agents = new Map([['a', agent('a', ['missing'])]]);
50
+ expect(() => resolveExecutionOrder(agents)).toThrow(MissingDependencyError);
51
+ });
52
+ it('handles agents with no dependsOn field', () => {
53
+ const agents = new Map([
54
+ ['a', { name: 'a', type: 'shell', command: 'echo a' }],
55
+ ['b', { name: 'b', type: 'shell', command: 'echo b' }],
56
+ ]);
57
+ const order = resolveExecutionOrder(agents);
58
+ expect(order.length).toBe(2);
59
+ });
60
+ });
61
+ describe('resolveTemplate', () => {
62
+ it('resolves result template', () => {
63
+ const outputs = new Map([['fetch', { result: 'hello', exitCode: 0 }]]);
64
+ expect(resolveTemplate('got: {{outputs.fetch.result}}', outputs)).toBe('got: hello');
65
+ });
66
+ it('resolves exitCode template', () => {
67
+ const outputs = new Map([['fetch', { result: '', exitCode: 42 }]]);
68
+ expect(resolveTemplate('code: {{outputs.fetch.exitCode}}', outputs)).toBe('code: 42');
69
+ });
70
+ it('resolves multiple templates', () => {
71
+ const outputs = new Map([
72
+ ['a', { result: 'foo', exitCode: 0 }],
73
+ ['b', { result: 'bar', exitCode: 0 }],
74
+ ]);
75
+ expect(resolveTemplate('{{outputs.a.result}} and {{outputs.b.result}}', outputs)).toBe('foo and bar');
76
+ });
77
+ it('returns empty string for missing agent output', () => {
78
+ const outputs = new Map();
79
+ expect(resolveTemplate('got: {{outputs.missing.result}}', outputs)).toBe('got: ');
80
+ });
81
+ it('passes through non-template text', () => {
82
+ const outputs = new Map();
83
+ expect(resolveTemplate('plain text', outputs)).toBe('plain text');
84
+ });
85
+ });
86
+ //# sourceMappingURL=chain-resolver.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"chain-resolver.test.js","sourceRoot":"","sources":["../src/chain-resolver.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import type { AgentDefinition } from './types.js';
2
+ export type TrustLevel = 'local' | 'community';
3
+ export interface BuildEnvOptions {
4
+ agent: AgentDefinition;
5
+ trustLevel: TrustLevel;
6
+ secrets?: Record<string, string>;
7
+ processEnv?: Record<string, string | undefined>;
8
+ }
9
+ export interface BuildEnvResult {
10
+ env: Record<string, string>;
11
+ missingSecrets: string[];
12
+ warnings: string[];
13
+ }
14
+ export declare function buildAgentEnv(options: BuildEnvOptions): BuildEnvResult;
15
+ export declare function getTrustLevel(agent: AgentDefinition): TrustLevel;
16
+ //# sourceMappingURL=env-builder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env-builder.d.ts","sourceRoot":"","sources":["../src/env-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,eAAe,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAkBD,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CA+CtE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAGhE"}
@@ -0,0 +1,59 @@
1
+ // Env vars safe for all agents regardless of trust level
2
+ const MINIMAL_ALLOWLIST = ['PATH', 'HOME', 'LANG', 'TERM', 'TMPDIR'];
3
+ // Additional env vars for local/trusted agents
4
+ const LOCAL_ALLOWLIST = [
5
+ ...MINIMAL_ALLOWLIST,
6
+ 'USER', 'SHELL', 'NODE_ENV', 'TZ',
7
+ ];
8
+ // Patterns to match for local trust (e.g. LC_ALL, LC_CTYPE)
9
+ const LOCAL_PATTERNS = [/^LC_/];
10
+ // Heuristic: keys that suggest the value is a secret
11
+ const SECRET_KEY_PATTERNS = /KEY|SECRET|TOKEN|PASSWORD|CREDENTIAL|AUTH/i;
12
+ const SECRET_VALUE_MIN_LENGTH = 20;
13
+ export function buildAgentEnv(options) {
14
+ const { agent, trustLevel, secrets = {}, processEnv = process.env } = options;
15
+ const warnings = [];
16
+ const missingSecrets = [];
17
+ const env = {};
18
+ // Step 1: Filter process.env based on trust level
19
+ const baseAllowlist = trustLevel === 'community' ? MINIMAL_ALLOWLIST : LOCAL_ALLOWLIST;
20
+ const extraAllowlist = agent.envAllowlist ?? [];
21
+ const allowedKeys = new Set([...baseAllowlist, ...extraAllowlist]);
22
+ for (const [key, value] of Object.entries(processEnv)) {
23
+ if (value === undefined)
24
+ continue;
25
+ if (allowedKeys.has(key)) {
26
+ env[key] = value;
27
+ continue;
28
+ }
29
+ // For local trust, also match patterns like LC_*
30
+ if (trustLevel === 'local' && LOCAL_PATTERNS.some(p => p.test(key))) {
31
+ env[key] = value;
32
+ }
33
+ }
34
+ // Step 2: Resolve declared secrets
35
+ for (const secretName of agent.secrets ?? []) {
36
+ if (secretName in secrets) {
37
+ env[secretName] = secrets[secretName];
38
+ }
39
+ else {
40
+ missingSecrets.push(secretName);
41
+ }
42
+ }
43
+ // Step 3: Apply agent's env field (YAML-declared key-values)
44
+ for (const [key, value] of Object.entries(agent.env ?? {})) {
45
+ // Warn if value looks like a hardcoded secret
46
+ if (SECRET_KEY_PATTERNS.test(key) && value.length >= SECRET_VALUE_MIN_LENGTH) {
47
+ warnings.push(`Agent "${agent.name}" has env var "${key}" that looks like a hardcoded secret. ` +
48
+ `Use the "secrets" field instead: sua secrets set ${key}`);
49
+ }
50
+ env[key] = value;
51
+ }
52
+ return { env, missingSecrets, warnings };
53
+ }
54
+ export function getTrustLevel(agent) {
55
+ if (agent.source === 'community')
56
+ return 'community';
57
+ return 'local';
58
+ }
59
+ //# sourceMappingURL=env-builder.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env-builder.js","sourceRoot":"","sources":["../src/env-builder.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=env-builder.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env-builder.test.d.ts","sourceRoot":"","sources":["../src/env-builder.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,167 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import { buildAgentEnv } from './env-builder.js';
3
+ const FAKE_PROCESS_ENV = {
4
+ PATH: '/usr/bin',
5
+ HOME: '/home/user',
6
+ USER: 'testuser',
7
+ SHELL: '/bin/bash',
8
+ LANG: 'en_US.UTF-8',
9
+ LC_ALL: 'en_US.UTF-8',
10
+ TERM: 'xterm',
11
+ TMPDIR: '/tmp',
12
+ NODE_ENV: 'development',
13
+ TZ: 'America/Los_Angeles',
14
+ // Dangerous vars that should NOT leak to community agents
15
+ AWS_SECRET_ACCESS_KEY: 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY',
16
+ GITHUB_TOKEN: 'ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
17
+ ANTHROPIC_API_KEY: 'sk-ant-api03-xxxxxxxxxxxx',
18
+ OPENAI_API_KEY: 'sk-xxxxxxxxxxxxxxxxxxxx',
19
+ DATABASE_URL: 'postgres://user:pass@localhost/db',
20
+ CUSTOM_VAR: 'custom-value',
21
+ };
22
+ function makeAgent(overrides = {}) {
23
+ return {
24
+ name: 'test-agent',
25
+ type: 'shell',
26
+ command: 'echo test',
27
+ ...overrides,
28
+ };
29
+ }
30
+ describe('buildAgentEnv — community trust', () => {
31
+ it('does NOT leak AWS_SECRET_ACCESS_KEY', () => {
32
+ const { env } = buildAgentEnv({
33
+ agent: makeAgent({ source: 'community' }),
34
+ trustLevel: 'community',
35
+ processEnv: FAKE_PROCESS_ENV,
36
+ });
37
+ expect(env.AWS_SECRET_ACCESS_KEY).toBeUndefined();
38
+ });
39
+ it('does NOT leak GITHUB_TOKEN', () => {
40
+ const { env } = buildAgentEnv({
41
+ agent: makeAgent({ source: 'community' }),
42
+ trustLevel: 'community',
43
+ processEnv: FAKE_PROCESS_ENV,
44
+ });
45
+ expect(env.GITHUB_TOKEN).toBeUndefined();
46
+ });
47
+ it('does NOT leak ANTHROPIC_API_KEY', () => {
48
+ const { env } = buildAgentEnv({
49
+ agent: makeAgent({ source: 'community' }),
50
+ trustLevel: 'community',
51
+ processEnv: FAKE_PROCESS_ENV,
52
+ });
53
+ expect(env.ANTHROPIC_API_KEY).toBeUndefined();
54
+ });
55
+ it('does NOT leak DATABASE_URL', () => {
56
+ const { env } = buildAgentEnv({
57
+ agent: makeAgent({ source: 'community' }),
58
+ trustLevel: 'community',
59
+ processEnv: FAKE_PROCESS_ENV,
60
+ });
61
+ expect(env.DATABASE_URL).toBeUndefined();
62
+ });
63
+ it('allows PATH and HOME', () => {
64
+ const { env } = buildAgentEnv({
65
+ agent: makeAgent({ source: 'community' }),
66
+ trustLevel: 'community',
67
+ processEnv: FAKE_PROCESS_ENV,
68
+ });
69
+ expect(env.PATH).toBe('/usr/bin');
70
+ expect(env.HOME).toBe('/home/user');
71
+ });
72
+ it('does NOT allow USER or SHELL for community', () => {
73
+ const { env } = buildAgentEnv({
74
+ agent: makeAgent({ source: 'community' }),
75
+ trustLevel: 'community',
76
+ processEnv: FAKE_PROCESS_ENV,
77
+ });
78
+ expect(env.USER).toBeUndefined();
79
+ expect(env.SHELL).toBeUndefined();
80
+ });
81
+ it('allows explicitly allowlisted vars', () => {
82
+ const { env } = buildAgentEnv({
83
+ agent: makeAgent({ source: 'community', envAllowlist: ['CUSTOM_VAR'] }),
84
+ trustLevel: 'community',
85
+ processEnv: FAKE_PROCESS_ENV,
86
+ });
87
+ expect(env.CUSTOM_VAR).toBe('custom-value');
88
+ });
89
+ });
90
+ describe('buildAgentEnv — local trust', () => {
91
+ it('allows PATH, HOME, USER, SHELL', () => {
92
+ const { env } = buildAgentEnv({
93
+ agent: makeAgent({ source: 'local' }),
94
+ trustLevel: 'local',
95
+ processEnv: FAKE_PROCESS_ENV,
96
+ });
97
+ expect(env.PATH).toBe('/usr/bin');
98
+ expect(env.HOME).toBe('/home/user');
99
+ expect(env.USER).toBe('testuser');
100
+ expect(env.SHELL).toBe('/bin/bash');
101
+ });
102
+ it('allows LC_* pattern vars', () => {
103
+ const { env } = buildAgentEnv({
104
+ agent: makeAgent({ source: 'local' }),
105
+ trustLevel: 'local',
106
+ processEnv: FAKE_PROCESS_ENV,
107
+ });
108
+ expect(env.LC_ALL).toBe('en_US.UTF-8');
109
+ });
110
+ it('still does NOT leak AWS_SECRET_ACCESS_KEY for local agents', () => {
111
+ const { env } = buildAgentEnv({
112
+ agent: makeAgent({ source: 'local' }),
113
+ trustLevel: 'local',
114
+ processEnv: FAKE_PROCESS_ENV,
115
+ });
116
+ expect(env.AWS_SECRET_ACCESS_KEY).toBeUndefined();
117
+ });
118
+ });
119
+ describe('buildAgentEnv — secrets', () => {
120
+ it('injects declared secrets', () => {
121
+ const { env, missingSecrets } = buildAgentEnv({
122
+ agent: makeAgent({ secrets: ['MY_API_KEY'] }),
123
+ trustLevel: 'local',
124
+ secrets: { MY_API_KEY: 'secret-value' },
125
+ processEnv: FAKE_PROCESS_ENV,
126
+ });
127
+ expect(env.MY_API_KEY).toBe('secret-value');
128
+ expect(missingSecrets).toEqual([]);
129
+ });
130
+ it('reports missing secrets', () => {
131
+ const { missingSecrets } = buildAgentEnv({
132
+ agent: makeAgent({ secrets: ['MISSING_KEY'] }),
133
+ trustLevel: 'local',
134
+ secrets: {},
135
+ processEnv: FAKE_PROCESS_ENV,
136
+ });
137
+ expect(missingSecrets).toEqual(['MISSING_KEY']);
138
+ });
139
+ });
140
+ describe('buildAgentEnv — agent env field', () => {
141
+ it('applies agent env values', () => {
142
+ const { env } = buildAgentEnv({
143
+ agent: makeAgent({ env: { FOO: 'bar' } }),
144
+ trustLevel: 'local',
145
+ processEnv: FAKE_PROCESS_ENV,
146
+ });
147
+ expect(env.FOO).toBe('bar');
148
+ });
149
+ it('warns on hardcoded secret-looking values', () => {
150
+ const { warnings } = buildAgentEnv({
151
+ agent: makeAgent({ env: { API_KEY: 'sk-1234567890abcdefghij' } }),
152
+ trustLevel: 'local',
153
+ processEnv: FAKE_PROCESS_ENV,
154
+ });
155
+ expect(warnings.length).toBe(1);
156
+ expect(warnings[0]).toContain('hardcoded secret');
157
+ });
158
+ it('does NOT warn on short values', () => {
159
+ const { warnings } = buildAgentEnv({
160
+ agent: makeAgent({ env: { API_KEY: 'short' } }),
161
+ trustLevel: 'local',
162
+ processEnv: FAKE_PROCESS_ENV,
163
+ });
164
+ expect(warnings.length).toBe(0);
165
+ });
166
+ });
167
+ //# sourceMappingURL=env-builder.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"env-builder.test.js","sourceRoot":"","sources":["../src/env-builder.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ export * from './types.js';
2
+ export * from './schema.js';
3
+ export * from './agent-loader.js';
4
+ export * from './run-store.js';
5
+ export * from './agent-executor.js';
6
+ export * from './local-provider.js';
7
+ export * from './chain-resolver.js';
8
+ export * from './chain-executor.js';
9
+ export * from './env-builder.js';
10
+ export * from './secrets-store.js';
11
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,11 @@
1
+ export * from './types.js';
2
+ export * from './schema.js';
3
+ export * from './agent-loader.js';
4
+ export * from './run-store.js';
5
+ export * from './agent-executor.js';
6
+ export * from './local-provider.js';
7
+ export * from './chain-resolver.js';
8
+ export * from './chain-executor.js';
9
+ export * from './env-builder.js';
10
+ export * from './secrets-store.js';
11
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}
@@ -0,0 +1,24 @@
1
+ import type { Provider, AgentDefinition, Run, RunStatus } from './types.js';
2
+ import type { SecretsStore } from './secrets-store.js';
3
+ export declare class LocalProvider implements Provider {
4
+ name: string;
5
+ private store;
6
+ private secretsStore?;
7
+ private running;
8
+ constructor(dbPath: string, secretsStore?: SecretsStore);
9
+ initialize(): Promise<void>;
10
+ shutdown(): Promise<void>;
11
+ submitRun(request: {
12
+ agent: AgentDefinition;
13
+ triggeredBy: Run['triggeredBy'];
14
+ }): Promise<Run>;
15
+ getRun(runId: string): Promise<Run | null>;
16
+ listRuns(filter?: {
17
+ agentName?: string;
18
+ status?: RunStatus;
19
+ limit?: number;
20
+ }): Promise<Run[]>;
21
+ cancelRun(runId: string): Promise<void>;
22
+ getRunLogs(runId: string): Promise<string>;
23
+ }
24
+ //# sourceMappingURL=local-provider.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"local-provider.d.ts","sourceRoot":"","sources":["../src/local-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,qBAAa,aAAc,YAAW,QAAQ;IAC5C,IAAI,SAAW;IACf,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,OAAO,CAAsC;gBAEzC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,YAAY;IAKjD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAazB,SAAS,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,eAAe,CAAC;QAAC,WAAW,EAAE,GAAG,CAAC,aAAa,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAmD7F,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAI1C,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAI7F,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAavC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAQjD"}
@@ -0,0 +1,101 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { RunStore } from './run-store.js';
3
+ import { executeAgent } from './agent-executor.js';
4
+ import { buildAgentEnv, getTrustLevel } from './env-builder.js';
5
+ export class LocalProvider {
6
+ name = 'local';
7
+ store;
8
+ secretsStore;
9
+ running = new Map();
10
+ constructor(dbPath, secretsStore) {
11
+ this.store = new RunStore(dbPath);
12
+ this.secretsStore = secretsStore;
13
+ }
14
+ async initialize() {
15
+ // No-op for local provider
16
+ }
17
+ async shutdown() {
18
+ for (const [id, handle] of this.running) {
19
+ handle.kill();
20
+ this.store.updateRun(id, {
21
+ status: 'cancelled',
22
+ completedAt: new Date().toISOString(),
23
+ error: 'Provider shutting down',
24
+ });
25
+ }
26
+ this.running.clear();
27
+ this.store.close();
28
+ }
29
+ async submitRun(request) {
30
+ const run = {
31
+ id: randomUUID(),
32
+ agentName: request.agent.name,
33
+ status: 'running',
34
+ startedAt: new Date().toISOString(),
35
+ triggeredBy: request.triggeredBy,
36
+ };
37
+ this.store.createRun(run);
38
+ const trustLevel = getTrustLevel(request.agent);
39
+ const secrets = this.secretsStore ? await this.secretsStore.getAll() : undefined;
40
+ const { env, missingSecrets, warnings } = buildAgentEnv({
41
+ agent: request.agent,
42
+ trustLevel,
43
+ secrets,
44
+ });
45
+ for (const w of warnings) {
46
+ console.warn(`[warning] ${w}`);
47
+ }
48
+ if (missingSecrets.length > 0) {
49
+ this.store.updateRun(run.id, {
50
+ status: 'failed',
51
+ completedAt: new Date().toISOString(),
52
+ error: `Missing secrets: ${missingSecrets.join(', ')}. Run: sua secrets set <name>`,
53
+ });
54
+ return this.store.getRun(run.id);
55
+ }
56
+ const handle = executeAgent(request.agent, env);
57
+ this.running.set(run.id, handle);
58
+ handle.promise.then((result) => {
59
+ this.running.delete(run.id);
60
+ const status = result.exitCode === 0 ? 'completed' : 'failed';
61
+ this.store.updateRun(run.id, {
62
+ status,
63
+ completedAt: new Date().toISOString(),
64
+ result: result.result,
65
+ exitCode: result.exitCode,
66
+ error: result.error,
67
+ });
68
+ });
69
+ return run;
70
+ }
71
+ async getRun(runId) {
72
+ return this.store.getRun(runId);
73
+ }
74
+ async listRuns(filter) {
75
+ return this.store.listRuns(filter);
76
+ }
77
+ async cancelRun(runId) {
78
+ const handle = this.running.get(runId);
79
+ if (handle) {
80
+ handle.kill();
81
+ this.running.delete(runId);
82
+ this.store.updateRun(runId, {
83
+ status: 'cancelled',
84
+ completedAt: new Date().toISOString(),
85
+ error: 'Cancelled by user',
86
+ });
87
+ }
88
+ }
89
+ async getRunLogs(runId) {
90
+ const run = this.store.getRun(runId);
91
+ if (!run)
92
+ return '';
93
+ const parts = [];
94
+ if (run.result)
95
+ parts.push(run.result);
96
+ if (run.error)
97
+ parts.push(`[ERROR] ${run.error}`);
98
+ return parts.join('\n') || '(no output)';
99
+ }
100
+ }
101
+ //# sourceMappingURL=local-provider.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"local-provider.js","sourceRoot":"","sources":["../src/local-provider.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import type { Run, RunStatus } from './types.js';
2
+ export declare class RunStore {
3
+ private db;
4
+ constructor(dbPath: string);
5
+ createRun(run: Run): void;
6
+ getRun(id: string): Run | null;
7
+ updateRun(id: string, updates: Partial<Pick<Run, 'status' | 'completedAt' | 'result' | 'exitCode' | 'error'>>): void;
8
+ listRuns(filter?: {
9
+ agentName?: string;
10
+ status?: RunStatus;
11
+ limit?: number;
12
+ }): Run[];
13
+ close(): void;
14
+ private rowToRun;
15
+ }
16
+ //# sourceMappingURL=run-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"run-store.d.ts","sourceRoot":"","sources":["../src/run-store.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,QAAQ;IACnB,OAAO,CAAC,EAAE,CAAe;gBAEb,MAAM,EAAE,MAAM;IA2B1B,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAUzB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IAO9B,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI;IAiBpH,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,GAAG,EAAE;IA8BpF,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,QAAQ;CAajB"}