@xenosystem/agent-interface-contract 0.1.25 → 0.1.27

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 (59) hide show
  1. package/dist/account.d.ts +285 -0
  2. package/dist/account.d.ts.map +1 -0
  3. package/dist/account.js +2 -0
  4. package/dist/account.js.map +1 -0
  5. package/dist/accountMembership.d.ts +86 -0
  6. package/dist/accountMembership.d.ts.map +1 -0
  7. package/dist/accountMembership.js +2 -0
  8. package/dist/accountMembership.js.map +1 -0
  9. package/dist/audit.d.ts +29 -0
  10. package/dist/audit.d.ts.map +1 -0
  11. package/dist/audit.js +14 -0
  12. package/dist/audit.js.map +1 -0
  13. package/dist/backups.d.ts +43 -0
  14. package/dist/backups.d.ts.map +1 -0
  15. package/dist/backups.js +2 -0
  16. package/dist/backups.js.map +1 -0
  17. package/dist/browser.d.ts +117 -0
  18. package/dist/browser.d.ts.map +1 -0
  19. package/dist/browser.js +2 -0
  20. package/dist/browser.js.map +1 -0
  21. package/dist/engineering.d.ts +12 -8
  22. package/dist/engineering.d.ts.map +1 -1
  23. package/dist/environment.d.ts +30 -0
  24. package/dist/environment.d.ts.map +1 -0
  25. package/dist/environment.js +2 -0
  26. package/dist/environment.js.map +1 -0
  27. package/dist/index.d.ts +192 -3
  28. package/dist/index.d.ts.map +1 -1
  29. package/dist/index.js +45 -1
  30. package/dist/index.js.map +1 -1
  31. package/dist/inference.d.ts +34 -0
  32. package/dist/inference.d.ts.map +1 -0
  33. package/dist/inference.js +46 -0
  34. package/dist/inference.js.map +1 -0
  35. package/dist/notifications.d.ts +124 -0
  36. package/dist/notifications.d.ts.map +1 -0
  37. package/dist/notifications.js +2 -0
  38. package/dist/notifications.js.map +1 -0
  39. package/dist/rules.d.ts +20 -0
  40. package/dist/rules.d.ts.map +1 -0
  41. package/dist/rules.js +2 -0
  42. package/dist/rules.js.map +1 -0
  43. package/dist/scheduling.d.ts +45 -0
  44. package/dist/scheduling.d.ts.map +1 -0
  45. package/dist/scheduling.js +2 -0
  46. package/dist/scheduling.js.map +1 -0
  47. package/dist/usage.d.ts +44 -0
  48. package/dist/usage.d.ts.map +1 -0
  49. package/dist/usage.js +19 -0
  50. package/dist/usage.js.map +1 -0
  51. package/dist/workforce.d.ts +105 -0
  52. package/dist/workforce.d.ts.map +1 -0
  53. package/dist/workforce.js +173 -0
  54. package/dist/workforce.js.map +1 -0
  55. package/dist/workspaceFile.d.ts +7 -0
  56. package/dist/workspaceFile.d.ts.map +1 -0
  57. package/dist/workspaceFile.js +42 -0
  58. package/dist/workspaceFile.js.map +1 -0
  59. package/package.json +1 -1
@@ -0,0 +1,124 @@
1
+ /** Metadata-only projections; destination URLs, credentials and event submission remain host-private. */
2
+ export interface AgentNotificationScope {
3
+ workspaceId: string;
4
+ teamId?: string;
5
+ agentId?: string;
6
+ }
7
+ export type AgentNotificationChannel = 'webhook' | 'slack' | 'discord';
8
+ export interface AgentNotificationRule {
9
+ id?: string;
10
+ event: 'agent.finished' | 'agent.failed' | 'agent.cancelled';
11
+ channel: AgentNotificationChannel;
12
+ destinationId: string;
13
+ enabled: boolean;
14
+ }
15
+ export interface AgentNotificationSettings {
16
+ success: true;
17
+ channelVersion?: 2;
18
+ revision: string;
19
+ rules: AgentNotificationRule[];
20
+ destinations: AgentNotificationDestination[];
21
+ channels: Array<{
22
+ id: 'webhook' | 'email' | 'slack' | 'discord';
23
+ available: boolean;
24
+ }>;
25
+ digestFrequencies: string[];
26
+ deliveries: Array<{
27
+ id: string;
28
+ destination_id: string;
29
+ event: string;
30
+ state: string;
31
+ attempt: number;
32
+ max_attempts: number;
33
+ status_code: number | null;
34
+ error_code: string | null;
35
+ created_at: string;
36
+ delivered_at: string | null;
37
+ next_retry_at: string | null;
38
+ cancelled_at: string | null;
39
+ }>;
40
+ }
41
+ export interface AgentNotificationDestination {
42
+ id: string;
43
+ label: string;
44
+ channel: AgentNotificationChannel;
45
+ ready: boolean;
46
+ enabled: boolean;
47
+ updatedAt: string;
48
+ }
49
+ export interface AgentNotificationDeliveryControl {
50
+ id: string;
51
+ state: string;
52
+ attempt: number;
53
+ maxAttempts: number;
54
+ }
55
+ export type AgentNotificationDestinationIntent = {
56
+ action: 'create';
57
+ url: string;
58
+ } | {
59
+ action: 'update';
60
+ destinationId: string;
61
+ expectedUpdatedAt: string;
62
+ url?: string;
63
+ enabled?: boolean;
64
+ } | {
65
+ action: 'delete';
66
+ destinationId: string;
67
+ expectedUpdatedAt: string;
68
+ } | {
69
+ action: 'delivery-control';
70
+ destinationId: string;
71
+ deliveryId: string;
72
+ operation: 'retry' | 'cancel';
73
+ };
74
+ export interface AgentNotificationDestinationMutation {
75
+ operationId: string;
76
+ action: AgentNotificationDestinationIntent['action'];
77
+ outcome: 'prepared' | 'pending' | 'uncertain' | 'committed' | 'rejected';
78
+ secretDelivery: 'not-applicable' | 'available' | 'unavailable';
79
+ destination?: AgentNotificationDestination;
80
+ delivery?: AgentNotificationDeliveryControl;
81
+ rejection?: 'notification_destination_not_found' | 'notification_destination_generation_conflict' | 'notification_delivery_transition_unavailable';
82
+ }
83
+ export type AgentNotificationsRequest = {
84
+ action: 'read';
85
+ scope: AgentNotificationScope;
86
+ } | {
87
+ action: 'save';
88
+ scope: AgentNotificationScope;
89
+ expectedRevision: string;
90
+ rules: AgentNotificationRule[];
91
+ } | {
92
+ action: 'prepare-destination';
93
+ scope: AgentNotificationScope;
94
+ operationId: string;
95
+ intent: AgentNotificationDestinationIntent;
96
+ } | {
97
+ action: 'destination-operation';
98
+ scope: AgentNotificationScope;
99
+ operationId: string;
100
+ } | {
101
+ action: 'execute-destination';
102
+ scope: AgentNotificationScope;
103
+ operationId: string;
104
+ } | {
105
+ action: 'copy-destination-secret';
106
+ scope: AgentNotificationScope;
107
+ operationId: string;
108
+ secretReceiptId: string;
109
+ };
110
+ export interface AgentNotificationsResult {
111
+ success: boolean;
112
+ settings?: AgentNotificationSettings;
113
+ sourceActive?: boolean;
114
+ pending?: number;
115
+ destinationMutation?: AgentNotificationDestinationMutation;
116
+ secretReceipt?: {
117
+ id: string;
118
+ expiresAt: string;
119
+ };
120
+ secretCopied?: boolean;
121
+ code?: 'UNCONFIGURED' | 'REFUSED' | 'CONFLICT' | 'UNCERTAIN';
122
+ error?: string;
123
+ }
124
+ //# sourceMappingURL=notifications.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=notifications.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"notifications.js","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":""}
@@ -0,0 +1,20 @@
1
+ export interface AgentWorkspaceRulesRequest {
2
+ action: 'get' | 'set' | 'reset';
3
+ workspaceId: string;
4
+ path?: string;
5
+ expectedRevision?: string;
6
+ expectedRulesRevision?: string;
7
+ }
8
+ /** Only metadata crosses IPC; contents are resolved privately at execution time. */
9
+ export interface AgentWorkspaceRulesResult {
10
+ success: boolean;
11
+ mode?: 'default' | 'override';
12
+ path?: string;
13
+ bytes?: number;
14
+ contentHash?: string;
15
+ revision?: string;
16
+ rulesRevision?: string;
17
+ valid?: boolean;
18
+ error?: string;
19
+ }
20
+ //# sourceMappingURL=rules.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,OAAO,CAAA;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AACD,oFAAoF;AACpF,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,CAAA;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}
package/dist/rules.js ADDED
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=rules.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rules.js","sourceRoot":"","sources":["../src/rules.ts"],"names":[],"mappings":""}
@@ -0,0 +1,45 @@
1
+ export type AgentScheduleAction = 'list' | 'create' | 'pause' | 'resume' | 'cancel' | 'history';
2
+ export interface AgentScheduleRun {
3
+ id: string;
4
+ startedAt: string;
5
+ completedAt?: string;
6
+ status: 'running' | 'completed' | 'failed' | 'interrupted';
7
+ error?: string;
8
+ }
9
+ export interface AgentScheduleJob {
10
+ id: string;
11
+ cron: string;
12
+ prompt: string;
13
+ cwd: string;
14
+ owner?: {
15
+ workspaceId: string;
16
+ teamId?: string;
17
+ agentId?: string;
18
+ };
19
+ nextRunAt: string;
20
+ lastRunAt?: string;
21
+ status?: 'active' | 'paused' | 'cancelled';
22
+ history?: AgentScheduleRun[];
23
+ }
24
+ export interface AgentScheduleRequest {
25
+ workspaceId: string;
26
+ workspaceRoot: string;
27
+ action: AgentScheduleAction;
28
+ id?: string;
29
+ cron?: string;
30
+ prompt?: string;
31
+ /** Stable create identity; retries must retain the same identity and submitted content. */
32
+ operationId?: string;
33
+ }
34
+ export interface AgentScheduleResult {
35
+ success: boolean;
36
+ jobs?: AgentScheduleJob[];
37
+ job?: AgentScheduleJob;
38
+ runs?: AgentScheduleRun[];
39
+ engine?: string;
40
+ timeZone?: string;
41
+ error?: string;
42
+ /** An unknown create may already exist. Retry the identical operation; never mint a replacement automatically. */
43
+ creationOutcome?: 'refused' | 'unknown';
44
+ }
45
+ //# sourceMappingURL=scheduling.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scheduling.d.ts","sourceRoot":"","sources":["../src/scheduling.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;AAC/F,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAA;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AACD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAClE,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAA;IAC1C,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAC7B;AACD,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,mBAAmB,CAAA;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AACD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,gBAAgB,EAAE,CAAA;IACzB,GAAG,CAAC,EAAE,gBAAgB,CAAA;IACtB,IAAI,CAAC,EAAE,gBAAgB,EAAE,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kHAAkH;IAClH,eAAe,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;CACxC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=scheduling.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scheduling.js","sourceRoot":"","sources":["../src/scheduling.ts"],"names":[],"mappings":""}
@@ -0,0 +1,44 @@
1
+ export interface AgentUsageRequest {
2
+ entityType: 'workspace' | 'team' | 'agent';
3
+ entityId: string;
4
+ }
5
+ export interface AgentUsageSnapshot {
6
+ source: 'local-runtime-journal';
7
+ observedAt: string;
8
+ totalTokens: number;
9
+ totalRequests: number;
10
+ unmeasuredRequests: number;
11
+ totalCost: null;
12
+ billingStatus: 'unavailable';
13
+ dailyUsage: Array<{
14
+ label: string;
15
+ value: number;
16
+ }>;
17
+ weeklyUsage: Array<{
18
+ label: string;
19
+ value: number;
20
+ }>;
21
+ monthlyUsage: Array<{
22
+ label: string;
23
+ value: number;
24
+ }>;
25
+ costByModel: Array<{
26
+ model: string;
27
+ tokens: number;
28
+ cost: null;
29
+ }>;
30
+ topAgents: Array<{
31
+ name: string;
32
+ tokens: number;
33
+ cost: null;
34
+ }>;
35
+ }
36
+ export type AgentUsageResult = {
37
+ success: true;
38
+ snapshot: AgentUsageSnapshot;
39
+ } | {
40
+ success: false;
41
+ error: string;
42
+ };
43
+ export declare function isAgentUsageResult(value: unknown): value is AgentUsageResult;
44
+ //# sourceMappingURL=usage.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,CAAA;IAC1C,QAAQ,EAAE,MAAM,CAAA;CACjB;AACD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,uBAAuB,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,SAAS,EAAE,IAAI,CAAA;IACf,aAAa,EAAE,aAAa,CAAA;IAC5B,UAAU,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACnD,WAAW,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACpD,YAAY,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACrD,WAAW,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAA;IACjE,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC,CAAA;CAC/D;AACD,MAAM,MAAM,gBAAgB,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,kBAAkB,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAElH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAc5E"}
package/dist/usage.js ADDED
@@ -0,0 +1,19 @@
1
+ export function isAgentUsageResult(value) {
2
+ if (!value || typeof value !== 'object' || Array.isArray(value))
3
+ return false;
4
+ const result = value;
5
+ if (result.success === false)
6
+ return typeof result.error === 'string';
7
+ if (result.success !== true || !result.snapshot || typeof result.snapshot !== 'object' || Array.isArray(result.snapshot))
8
+ return false;
9
+ const s = result.snapshot;
10
+ const count = (v) => typeof v === 'number' && Number.isSafeInteger(v) && v >= 0;
11
+ const list = (v, label, metric, cost = false) => Array.isArray(v) && v.every(item => item && typeof item === 'object' && !Array.isArray(item) && typeof item[label] === 'string' && count(item[metric]) && (!cost || item.cost === null));
12
+ return s.source === 'local-runtime-journal' && s.billingStatus === 'unavailable' && s.totalCost === null
13
+ && typeof s.observedAt === 'string' && Number.isFinite(Date.parse(s.observedAt))
14
+ && count(s.totalTokens) && count(s.totalRequests) && count(s.unmeasuredRequests)
15
+ && s.unmeasuredRequests <= s.totalRequests
16
+ && list(s.dailyUsage, 'label', 'value') && list(s.weeklyUsage, 'label', 'value') && list(s.monthlyUsage, 'label', 'value')
17
+ && list(s.costByModel, 'model', 'tokens', true) && list(s.topAgents, 'name', 'tokens', true);
18
+ }
19
+ //# sourceMappingURL=usage.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"usage.js","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC7E,MAAM,MAAM,GAAG,KAAgC,CAAA;IAC/C,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK;QAAE,OAAO,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAA;IACrE,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAA;IACtI,MAAM,CAAC,GAAG,MAAM,CAAC,QAAmC,CAAA;IACpD,MAAM,KAAK,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACxF,MAAM,IAAI,GAAG,CAAC,CAAU,EAAE,KAAa,EAAE,MAAc,EAAE,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAA;IAClQ,OAAO,CAAC,CAAC,MAAM,KAAK,uBAAuB,IAAI,CAAC,CAAC,aAAa,KAAK,aAAa,IAAI,CAAC,CAAC,SAAS,KAAK,IAAI;WACnG,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;WAC7E,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC;WAC5E,CAAC,CAAC,kBAA6B,IAAK,CAAC,CAAC,aAAwB;WAC/D,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC;WACvH,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAA;AAChG,CAAC"}
@@ -0,0 +1,105 @@
1
+ /** Resource creation and durable outcome reconciliation only. These inputs do
2
+ * not grant credentials, execution, membership, assignment or spending rights. */
3
+ export interface AgentWorkforceOwner {
4
+ type: 'user' | 'workspace';
5
+ id: string;
6
+ }
7
+ export interface AgentWorkforceDefinition {
8
+ schemaVersion: 1;
9
+ instructions: string;
10
+ skills: Array<{
11
+ id: string;
12
+ version: string;
13
+ hash: string;
14
+ }>;
15
+ requestedCapabilities: string[];
16
+ secretReferences?: Array<{
17
+ name: string;
18
+ ref: string;
19
+ }>;
20
+ provenance?: {
21
+ source: 'authored' | 'imported';
22
+ sourceVersion?: string;
23
+ };
24
+ license?: {
25
+ identifier: string;
26
+ };
27
+ }
28
+ export type AgentWorkforceResourceInput = {
29
+ owner: AgentWorkforceOwner;
30
+ name: string;
31
+ description?: string;
32
+ } & ({
33
+ kind: 'team';
34
+ } | {
35
+ kind: 'agent';
36
+ definition: AgentWorkforceDefinition;
37
+ });
38
+ interface RequestIdentity {
39
+ schemaVersion: 1;
40
+ operationId: string;
41
+ expectedAccountId: string;
42
+ }
43
+ export type AgentWorkforceRequest = RequestIdentity & ({
44
+ action: 'prepare';
45
+ resource: AgentWorkforceResourceInput;
46
+ } | {
47
+ action: 'execute';
48
+ retryAfterNotObserved?: boolean;
49
+ } | {
50
+ action: 'reconcile' | 'lookup' | 'cancel';
51
+ }) | AgentWorkforceListOwnedRequest;
52
+ export interface AgentWorkforceListOwnedRequest {
53
+ schemaVersion: 1;
54
+ action: 'list-owned';
55
+ expectedAccountId: string;
56
+ owner: AgentWorkforceOwner;
57
+ limit?: number;
58
+ kind?: 'agent' | 'team';
59
+ status?: 'active' | 'archived';
60
+ cursor?: string;
61
+ }
62
+ export interface AgentWorkforceResourceMetadata {
63
+ id: string;
64
+ kind: 'agent' | 'team';
65
+ owner: AgentWorkforceOwner;
66
+ createdByUserId: string | null;
67
+ name: string;
68
+ description: string;
69
+ status: 'active' | 'archived';
70
+ revision: string;
71
+ createdAt: string;
72
+ updatedAt: string;
73
+ }
74
+ export interface AgentWorkforceOwnedCatalog {
75
+ schemaVersion: 1;
76
+ scope: 'owned';
77
+ owner: AgentWorkforceOwner;
78
+ items: AgentWorkforceResourceMetadata[];
79
+ nextCursor: string | null;
80
+ }
81
+ export type AgentWorkforceState = 'prepared' | 'dispatched' | 'uncertain' | 'committed' | 'rejected' | 'cancelled';
82
+ export type AgentWorkforceFailure = 'REFUSED' | 'CONFLICT' | 'UNCERTAIN' | 'UNCONFIGURED' | 'REQUEST_FAILED' | 'ACCOUNT_CHANGED';
83
+ /** Metadata projection only. Full definitions, identities and token bundles are
84
+ * deliberately absent even when the owning service returns them privately. */
85
+ export interface AgentWorkforceResult {
86
+ schemaVersion: 1;
87
+ success: boolean;
88
+ operationId?: string;
89
+ state?: AgentWorkforceState;
90
+ resourceId?: string;
91
+ resourceRevision?: string;
92
+ agentVersion?: number | null;
93
+ committedAt?: string;
94
+ code?: AgentWorkforceFailure;
95
+ error?: string;
96
+ catalog?: AgentWorkforceOwnedCatalog;
97
+ }
98
+ export declare function parseAgentWorkforceRequest(value: unknown): AgentWorkforceRequest;
99
+ export declare function isAgentWorkforceRequest(value: unknown): value is AgentWorkforceRequest;
100
+ export declare function isAgentWorkforceResult(value: unknown): value is AgentWorkforceResult;
101
+ /** Strict owned metadata projection. This is not an assigned/global authority
102
+ * union, and never accepts instructions, capability definitions or secret refs. */
103
+ export declare function parseAgentWorkforceOwnedCatalog(value: unknown): AgentWorkforceOwnedCatalog;
104
+ export {};
105
+ //# sourceMappingURL=workforce.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workforce.d.ts","sourceRoot":"","sources":["../src/workforce.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,173 @@
1
+ const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
2
+ const ID = /^[a-zA-Z0-9][a-zA-Z0-9._:/@+-]{0,127}$/;
3
+ const encoder = new TextEncoder();
4
+ const uuid = (value) => typeof value === 'string' && UUID.test(value);
5
+ const text = (value, max, empty = false) => typeof value === 'string' && !value.includes('\0') && encoder.encode(value).length <= max && (empty || Boolean(value.trim()));
6
+ const identifier = (value) => typeof value === 'string' && ID.test(value);
7
+ const record = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
8
+ const only = (value, allowed) => Object.keys(value).every(key => allowed.includes(key));
9
+ const own = (value, key) => Object.hasOwn(value, key);
10
+ /** Snapshot before any await without invoking getters/toJSON or accepting
11
+ * inherited/symbol fields, sparse arrays, cycles or unbounded nested input. */
12
+ function snapshot(value, depth = 0, budget = { nodes: 4096, bytes: 262144 }) {
13
+ if (--budget.nodes < 0 || depth > 10)
14
+ throw new Error('Invalid workforce contract');
15
+ if (typeof value === 'string') {
16
+ budget.bytes -= encoder.encode(value).length;
17
+ if (budget.bytes < 0)
18
+ throw new Error('Invalid workforce contract');
19
+ return value;
20
+ }
21
+ if (value === null || typeof value === 'boolean' || (typeof value === 'number' && Number.isFinite(value)))
22
+ return value;
23
+ if (!value || typeof value !== 'object')
24
+ throw new Error('Invalid workforce contract');
25
+ const array = Array.isArray(value);
26
+ if (array ? Object.getPrototypeOf(value) !== Array.prototype : ![Object.prototype, null].includes(Object.getPrototypeOf(value)))
27
+ throw new Error('Invalid workforce contract');
28
+ const keys = Reflect.ownKeys(value);
29
+ if (keys.length > 4096 || (array && keys.length !== value.length + 1))
30
+ throw new Error('Invalid workforce contract');
31
+ const result = array ? [] : Object.create(null);
32
+ for (const key of keys) {
33
+ if (array && key === 'length')
34
+ continue;
35
+ const descriptor = Object.getOwnPropertyDescriptor(value, key);
36
+ if (typeof key !== 'string' || !descriptor?.enumerable || !Object.hasOwn(descriptor, 'value')
37
+ || (array && !/^(0|[1-9][0-9]*)$/.test(key)))
38
+ throw new Error('Invalid workforce contract');
39
+ if (array)
40
+ result.push(snapshot(descriptor.value, depth + 1, budget));
41
+ else
42
+ result[key] = snapshot(descriptor.value, depth + 1, budget);
43
+ }
44
+ return result;
45
+ }
46
+ function list(value, max, valid, key = item => item) {
47
+ return Array.isArray(value) && value.length <= max && value.every(valid) && new Set(value.map(key)).size === value.length;
48
+ }
49
+ function definition(value) {
50
+ if (!record(value) || !only(value, ['schemaVersion', 'instructions', 'skills', 'requestedCapabilities', 'secretReferences', 'provenance', 'license'])
51
+ || value.schemaVersion !== 1 || !text(value.instructions, 32768, true))
52
+ return false;
53
+ if (!list(value.skills, 64, item => record(item) && only(item, ['id', 'version', 'hash']) && identifier(item.id) && identifier(item.version)
54
+ && typeof item.hash === 'string' && /^[a-f0-9]{64}$/.test(item.hash), item => item.id)
55
+ || !list(value.requestedCapabilities, 64, identifier))
56
+ return false;
57
+ if (own(value, 'secretReferences') && !list(value.secretReferences, 32, item => record(item) && only(item, ['name', 'ref'])
58
+ && typeof item.name === 'string' && /^[A-Z][A-Z0-9_]{0,63}$/.test(item.name) && uuid(item.ref), item => item.name))
59
+ return false;
60
+ if (own(value, 'provenance')) {
61
+ const p = value.provenance;
62
+ if (!record(p) || !only(p, ['source', 'sourceVersion']) || !['authored', 'imported'].includes(String(p.source)) || (own(p, 'sourceVersion') && !identifier(p.sourceVersion)))
63
+ return false;
64
+ }
65
+ return !own(value, 'license') || (record(value.license) && only(value.license, ['identifier']) && identifier(value.license.identifier));
66
+ }
67
+ function validRequest(value) {
68
+ if (!record(value) || value.schemaVersion !== 1 || !uuid(value.expectedAccountId))
69
+ return false;
70
+ if (value.action === 'list-owned')
71
+ return only(value, ['schemaVersion', 'action', 'expectedAccountId', 'owner', 'limit', 'kind', 'status', 'cursor'])
72
+ && validOwner(value.owner) && (!own(value, 'limit') || (Number.isInteger(value.limit) && Number(value.limit) >= 1 && Number(value.limit) <= 100))
73
+ && (!own(value, 'kind') || ['agent', 'team'].includes(String(value.kind)))
74
+ && (!own(value, 'status') || ['active', 'archived'].includes(String(value.status)))
75
+ && (!own(value, 'cursor') || validCursor(value.cursor));
76
+ if (!uuid(value.operationId))
77
+ return false;
78
+ const common = ['schemaVersion', 'action', 'operationId', 'expectedAccountId'];
79
+ if (value.action === 'prepare') {
80
+ const r = value.resource;
81
+ if (!only(value, [...common, 'resource']) || !record(r) || !only(r, ['owner', 'kind', 'name', 'description', 'definition'])
82
+ || !record(r.owner) || !only(r.owner, ['type', 'id']) || !['user', 'workspace'].includes(String(r.owner.type)) || !uuid(r.owner.id)
83
+ || !text(r.name, 200) || (own(r, 'description') && !text(r.description, 4096, true)))
84
+ return false;
85
+ return r.kind === 'agent' ? definition(r.definition) : r.kind === 'team' && !own(r, 'definition');
86
+ }
87
+ if (value.action === 'execute')
88
+ return only(value, [...common, 'retryAfterNotObserved']) && (!own(value, 'retryAfterNotObserved') || typeof value.retryAfterNotObserved === 'boolean');
89
+ return ['lookup', 'reconcile', 'cancel'].includes(String(value.action)) && only(value, common);
90
+ }
91
+ export function parseAgentWorkforceRequest(value) {
92
+ const copy = snapshot(value);
93
+ if (!validRequest(copy) || encoder.encode(JSON.stringify(copy)).length > 262144)
94
+ throw new Error('Invalid workforce request');
95
+ // Pure representation normalization, never actor authentication.
96
+ copy.expectedAccountId = copy.expectedAccountId.toLowerCase();
97
+ if (copy.action === 'list-owned')
98
+ copy.owner.id = copy.owner.id.toLowerCase();
99
+ else
100
+ copy.operationId = copy.operationId.toLowerCase();
101
+ if (copy.action === 'prepare')
102
+ copy.resource.owner.id = copy.resource.owner.id.toLowerCase();
103
+ return copy;
104
+ }
105
+ export function isAgentWorkforceRequest(value) {
106
+ try {
107
+ parseAgentWorkforceRequest(value);
108
+ return true;
109
+ }
110
+ catch {
111
+ return false;
112
+ }
113
+ }
114
+ export function isAgentWorkforceResult(value) {
115
+ try {
116
+ const r = snapshot(value, 0, { nodes: 4096, bytes: 1048576 });
117
+ if (record(r) && own(r, 'catalog'))
118
+ return only(r, ['schemaVersion', 'success', 'catalog']) && r.schemaVersion === 1 && r.success === true && validCatalog(r.catalog);
119
+ if (!record(r) || !only(r, ['schemaVersion', 'success', 'operationId', 'state', 'resourceId', 'resourceRevision', 'agentVersion', 'committedAt', 'code', 'error'])
120
+ || r.schemaVersion !== 1 || typeof r.success !== 'boolean' || (own(r, 'operationId') && !uuid(r.operationId)))
121
+ return false;
122
+ if (own(r, 'state') && (!uuid(r.operationId) || !['prepared', 'dispatched', 'uncertain', 'committed', 'rejected', 'cancelled'].includes(String(r.state))))
123
+ return false;
124
+ if (r.success ? !['prepared', 'committed', 'cancelled'].includes(String(r.state)) || own(r, 'code') || own(r, 'error')
125
+ : !['REFUSED', 'CONFLICT', 'UNCERTAIN', 'UNCONFIGURED', 'REQUEST_FAILED', 'ACCOUNT_CHANGED'].includes(String(r.code)) || !text(r.error, 512))
126
+ return false;
127
+ if (r.state === 'committed')
128
+ return r.success && uuid(r.resourceId) && typeof r.resourceRevision === 'string'
129
+ && /^[1-9][0-9]{0,18}$/.test(r.resourceRevision) && BigInt(r.resourceRevision) <= 9223372036854775807n
130
+ && (r.agentVersion === null || (Number.isSafeInteger(r.agentVersion) && Number(r.agentVersion) > 0 && Number(r.agentVersion) <= 2147483647))
131
+ && typeof r.committedAt === 'string' && r.committedAt.length <= 40 && Number.isFinite(Date.parse(r.committedAt));
132
+ return !['resourceId', 'resourceRevision', 'agentVersion', 'committedAt'].some(key => own(r, key));
133
+ }
134
+ catch {
135
+ return false;
136
+ }
137
+ }
138
+ const validCursor = (value) => typeof value === 'string' && /^[a-zA-Z0-9_-]{1,2048}$/.test(value);
139
+ function validOwner(value) {
140
+ return record(value) && only(value, ['type', 'id']) && ['user', 'workspace'].includes(String(value.type)) && uuid(value.id);
141
+ }
142
+ const date = (value) => typeof value === 'string' && value.length <= 40
143
+ && /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/.test(value) && Number.isFinite(Date.parse(value));
144
+ function validCatalog(value) {
145
+ if (!record(value) || !only(value, ['schemaVersion', 'scope', 'owner', 'items', 'nextCursor']) || value.schemaVersion !== 1
146
+ || value.scope !== 'owned' || !validOwner(value.owner) || !(value.nextCursor === null || validCursor(value.nextCursor)))
147
+ return false;
148
+ const owner = value.owner;
149
+ return list(value.items, 100, item => record(item)
150
+ && only(item, ['id', 'kind', 'owner', 'createdByUserId', 'name', 'description', 'status', 'revision', 'createdAt', 'updatedAt'])
151
+ && uuid(item.id) && ['agent', 'team'].includes(String(item.kind)) && validOwner(item.owner)
152
+ && item.owner.type === owner.type && item.owner.id.toLowerCase() === owner.id.toLowerCase()
153
+ && (item.createdByUserId === null || uuid(item.createdByUserId)) && text(item.name, 200) && text(item.description, 4096, true)
154
+ && ['active', 'archived'].includes(String(item.status)) && typeof item.revision === 'string' && /^[1-9][0-9]{0,18}$/.test(item.revision)
155
+ && BigInt(item.revision) <= 9223372036854775807n && date(item.createdAt) && date(item.updatedAt), item => String(item.id).toLowerCase())
156
+ && (value.nextCursor === null || value.items.length > 0);
157
+ }
158
+ /** Strict owned metadata projection. This is not an assigned/global authority
159
+ * union, and never accepts instructions, capability definitions or secret refs. */
160
+ export function parseAgentWorkforceOwnedCatalog(value) {
161
+ const copy = snapshot(value, 0, { nodes: 4096, bytes: 1048576 });
162
+ if (!validCatalog(copy))
163
+ throw new Error('Invalid owned workforce catalog');
164
+ copy.owner.id = copy.owner.id.toLowerCase();
165
+ for (const item of copy.items) {
166
+ item.id = item.id.toLowerCase();
167
+ item.owner.id = item.owner.id.toLowerCase();
168
+ if (item.createdByUserId !== null)
169
+ item.createdByUserId = item.createdByUserId.toLowerCase();
170
+ }
171
+ return copy;
172
+ }
173
+ //# sourceMappingURL=workforce.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workforce.js","sourceRoot":"","sources":["../src/workforce.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ import { type AgentWorkspaceFileWriteRequest } from './index.js';
2
+ /** Shared executable wire validation. This does not grant filesystem authority. */
3
+ export declare const WORKSPACE_FILE_TEXT_MAX_BYTES: number;
4
+ /** Empty text is valid; missing/falsy non-string content is never an empty-file request. */
5
+ export declare function isBoundedWorkspaceFileText(value: unknown): value is string;
6
+ export declare function isAgentWorkspaceFileWriteRequest(value: unknown): value is AgentWorkspaceFileWriteRequest;
7
+ //# sourceMappingURL=workspaceFile.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workspaceFile.d.ts","sourceRoot":"","sources":["../src/workspaceFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,8BAA8B,EAAE,MAAM,YAAY,CAAA;AAE3F,mFAAmF;AACnF,eAAO,MAAM,6BAA6B,QAAc,CAAA;AAKxD,4FAA4F;AAC5F,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAY1E;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,8BAA8B,CAWxG"}