@agentapps/station 0.0.0-stage → 0.2.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 (75) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +58 -2
  3. package/dist/api-key-store.d.ts +46 -0
  4. package/dist/api-key-store.d.ts.map +1 -0
  5. package/dist/api-key-store.js +84 -0
  6. package/dist/api-key-store.js.map +1 -0
  7. package/dist/app-station.d.ts +129 -0
  8. package/dist/app-station.d.ts.map +1 -0
  9. package/dist/app-station.js +706 -0
  10. package/dist/app-station.js.map +1 -0
  11. package/dist/approval-manager.d.ts +75 -0
  12. package/dist/approval-manager.d.ts.map +1 -0
  13. package/dist/approval-manager.js +96 -0
  14. package/dist/approval-manager.js.map +1 -0
  15. package/dist/document-store.d.ts +86 -0
  16. package/dist/document-store.d.ts.map +1 -0
  17. package/dist/document-store.js +230 -0
  18. package/dist/document-store.js.map +1 -0
  19. package/dist/file-handlers/object-store.d.ts +113 -0
  20. package/dist/file-handlers/object-store.d.ts.map +1 -0
  21. package/dist/file-handlers/object-store.js +273 -0
  22. package/dist/file-handlers/object-store.js.map +1 -0
  23. package/dist/file-handlers/signed-url.d.ts +44 -0
  24. package/dist/file-handlers/signed-url.d.ts.map +1 -0
  25. package/dist/file-handlers/signed-url.js +68 -0
  26. package/dist/file-handlers/signed-url.js.map +1 -0
  27. package/dist/file-handlers/volume-handlers.d.ts +136 -0
  28. package/dist/file-handlers/volume-handlers.d.ts.map +1 -0
  29. package/dist/file-handlers/volume-handlers.js +426 -0
  30. package/dist/file-handlers/volume-handlers.js.map +1 -0
  31. package/dist/in-process-runtime.d.ts +49 -0
  32. package/dist/in-process-runtime.d.ts.map +1 -0
  33. package/dist/in-process-runtime.js +50 -0
  34. package/dist/in-process-runtime.js.map +1 -0
  35. package/dist/index.d.ts +27 -0
  36. package/dist/index.d.ts.map +1 -0
  37. package/dist/index.js +34 -0
  38. package/dist/index.js.map +1 -0
  39. package/dist/local-process-runtime.d.ts +28 -0
  40. package/dist/local-process-runtime.d.ts.map +1 -0
  41. package/dist/local-process-runtime.js +134 -0
  42. package/dist/local-process-runtime.js.map +1 -0
  43. package/dist/oauth-manager.d.ts +90 -0
  44. package/dist/oauth-manager.d.ts.map +1 -0
  45. package/dist/oauth-manager.js +148 -0
  46. package/dist/oauth-manager.js.map +1 -0
  47. package/dist/oauth-pages.d.ts +9 -0
  48. package/dist/oauth-pages.d.ts.map +1 -0
  49. package/dist/oauth-pages.js +59 -0
  50. package/dist/oauth-pages.js.map +1 -0
  51. package/dist/permission-enforcer.d.ts +52 -0
  52. package/dist/permission-enforcer.d.ts.map +1 -0
  53. package/dist/permission-enforcer.js +144 -0
  54. package/dist/permission-enforcer.js.map +1 -0
  55. package/dist/policy-store.d.ts +34 -0
  56. package/dist/policy-store.d.ts.map +1 -0
  57. package/dist/policy-store.js +35 -0
  58. package/dist/policy-store.js.map +1 -0
  59. package/dist/secrets-manager.d.ts +32 -0
  60. package/dist/secrets-manager.d.ts.map +1 -0
  61. package/dist/secrets-manager.js +12 -0
  62. package/dist/secrets-manager.js.map +1 -0
  63. package/dist/server.d.ts +368 -0
  64. package/dist/server.d.ts.map +1 -0
  65. package/dist/server.js +1954 -0
  66. package/dist/server.js.map +1 -0
  67. package/dist/telemetry.d.ts +9 -0
  68. package/dist/telemetry.d.ts.map +1 -0
  69. package/dist/telemetry.js +9 -0
  70. package/dist/telemetry.js.map +1 -0
  71. package/dist/types.d.ts +47 -0
  72. package/dist/types.d.ts.map +1 -0
  73. package/dist/types.js +9 -0
  74. package/dist/types.js.map +1 -0
  75. package/package.json +40 -3
@@ -0,0 +1 @@
1
+ {"version":3,"file":"local-process-runtime.d.ts","sourceRoot":"","sources":["../src/local-process-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9E,MAAM,WAAW,0BAA0B;IACzC,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,qBAAa,mBAAoB,YAAW,cAAc;IAW5C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAVpC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,SAAS,CAOb;gBAEyB,OAAO,EAAE,0BAA0B;IAE1D,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;IA2HzD,2CAA2C;IAC3C,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,0EAA0E;IAC1E,MAAM,CACJ,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,KAAK,IAAI,GACpE,IAAI;CAMR"}
@@ -0,0 +1,134 @@
1
+ /**
2
+ * LocalProcessRuntime — runtime adapter that spawns apps as child processes
3
+ * communicating via stdio (MCP JSON-lines framing).
4
+ *
5
+ * Each spawn() creates a new node child process, wires a StdioTransport
6
+ * across stdin/stdout, and returns an InstanceHandle for lifecycle management.
7
+ */
8
+ import { spawn } from 'node:child_process';
9
+ import { createEnvelope, StdioTransport, } from '@agentapps/protocol';
10
+ export class LocalProcessRuntime {
11
+ options;
12
+ counter = 0;
13
+ instances = new Map();
14
+ constructor(options) {
15
+ this.options = options;
16
+ }
17
+ async spawn(config) {
18
+ this.counter++;
19
+ const instanceId = `localproc_${config.installationId}_${this.counter}`;
20
+ const nodePath = this.options.nodePath ?? 'node';
21
+ const child = spawn(nodePath, [this.options.entryPoint], {
22
+ stdio: ['pipe', 'pipe', 'pipe'],
23
+ env: {
24
+ ...process.env,
25
+ ...this.options.env,
26
+ // VOL-REQ-5: mount mode reaches a child process through its environment.
27
+ ...(config.volumePath ? { AGENTAPPS_VOLUME_PATH: config.volumePath } : {}),
28
+ },
29
+ });
30
+ if (!child.stdin || !child.stdout || !child.stderr) {
31
+ throw new Error(`Failed to spawn child process: stdio pipes not available for ${this.options.entryPoint}`);
32
+ }
33
+ // Redirect stderr to logs
34
+ child.stderr.on('data', (data) => {
35
+ const lines = data.toString('utf-8').trim().split('\n');
36
+ for (const line of lines) {
37
+ if (line) {
38
+ // eslint-disable-next-line no-console
39
+ console.error(`[${instanceId}] ${line}`);
40
+ }
41
+ }
42
+ });
43
+ // Create transport with crossed streams:
44
+ // app station writes to child.stdin, reads from child.stdout
45
+ const transport = new StdioTransport({
46
+ stdin: child.stdout,
47
+ stdout: child.stdin,
48
+ });
49
+ // Track instance for cleanup
50
+ const instanceState = {
51
+ child,
52
+ transport,
53
+ onExit: (_code, _signal) => { },
54
+ };
55
+ this.instances.set(instanceId, instanceState);
56
+ // Crash detection
57
+ child.on('exit', (code, signal) => {
58
+ instanceState.onExit(code, signal);
59
+ this.instances.delete(instanceId);
60
+ });
61
+ return {
62
+ instanceId,
63
+ send(msg) {
64
+ transport.send(msg);
65
+ },
66
+ onMessage(handler) {
67
+ return transport.onMessage(handler);
68
+ },
69
+ isAlive() {
70
+ return child.exitCode === null && child.signalCode === null;
71
+ },
72
+ async stop(gracePeriodMs) {
73
+ // 1. Send shutdown message (graceful protocol-level shutdown)
74
+ if (child.exitCode === null && child.signalCode === null) {
75
+ try {
76
+ transport.send({
77
+ ...createEnvelope('shutdown'),
78
+ id: `shutdown_${instanceId}`,
79
+ sessionId: config.installationId,
80
+ });
81
+ }
82
+ catch {
83
+ // Transport may already be closed; proceed to signals
84
+ }
85
+ // 2. Wait grace period for the child to exit voluntarily
86
+ await new Promise((resolve) => {
87
+ const timer = setTimeout(() => {
88
+ child.off('exit', onExit);
89
+ resolve();
90
+ }, gracePeriodMs);
91
+ const onExit = () => {
92
+ clearTimeout(timer);
93
+ resolve();
94
+ };
95
+ child.once('exit', onExit);
96
+ });
97
+ }
98
+ // 3. SIGTERM if still alive
99
+ if (child.exitCode === null && child.signalCode === null) {
100
+ child.kill('SIGTERM');
101
+ await new Promise((resolve) => {
102
+ const timer = setTimeout(() => {
103
+ child.off('exit', onExit);
104
+ resolve();
105
+ }, 5_000);
106
+ const onExit = () => {
107
+ clearTimeout(timer);
108
+ resolve();
109
+ };
110
+ child.once('exit', onExit);
111
+ });
112
+ }
113
+ // 4. SIGKILL if still alive
114
+ if (child.exitCode === null && child.signalCode === null) {
115
+ child.kill('SIGKILL');
116
+ }
117
+ // 5. Clean up transport
118
+ await transport.close();
119
+ },
120
+ };
121
+ }
122
+ /** Get the number of tracked instances. */
123
+ get instanceCount() {
124
+ return this.instances.size;
125
+ }
126
+ /** Set a request for when a child process exits (for crash detection). */
127
+ onExit(instanceId, request) {
128
+ const state = this.instances.get(instanceId);
129
+ if (state) {
130
+ state.onExit = request;
131
+ }
132
+ }
133
+ }
134
+ //# sourceMappingURL=local-process-runtime.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"local-process-runtime.js","sourceRoot":"","sources":["../src/local-process-runtime.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,90 @@
1
+ /**
2
+ * OAuthManager — server-side OAuth flow for the app station.
3
+ *
4
+ * Manages pending authorization requests and handles the token exchange
5
+ * when the provider redirects back to the app station's public callback
6
+ * endpoint. Supports multiple concurrent users and apps on the same
7
+ * app station instance.
8
+ *
9
+ * Flow:
10
+ * 1. Client calls GET /auth/start → OAuthManager generates the authorize
11
+ * URL and stores a pending entry keyed by a random `state`.
12
+ * 2. User completes consent in the browser → provider redirects to
13
+ * GET /auth/callback?code=X&state=Y.
14
+ * 3. OAuthManager exchanges the code for tokens and returns them so the
15
+ * server can persist them via the SecretsManager.
16
+ */
17
+ export interface OAuthStartParams {
18
+ /** Unique installation ID (e.g. "ins_a7f3b2c1"). Used for token storage. */
19
+ installationId: string;
20
+ /** App type ID (e.g. "app.google.gmail"). Used for app manifest lookup. */
21
+ appId: string;
22
+ /** Tenant context — who initiated the auth. */
23
+ tenant?: {
24
+ userId: string;
25
+ workspaceId?: string;
26
+ };
27
+ /** Provider name (e.g. "google", "github", "notion"). */
28
+ provider: string;
29
+ /** Full authorize URL (e.g. https://accounts.google.com/o/oauth2/v2/auth). */
30
+ authorizeUrl: string;
31
+ /** Token endpoint URL. */
32
+ tokenUrl: string;
33
+ /** OAuth client ID. */
34
+ clientId: string;
35
+ /** OAuth client secret. */
36
+ clientSecret: string;
37
+ /** Where the provider should redirect after consent. */
38
+ redirectUri: string;
39
+ /** Requested scopes. */
40
+ scopes?: string[];
41
+ }
42
+ export interface PendingAuth {
43
+ params: OAuthStartParams;
44
+ state: string;
45
+ createdAt: number;
46
+ timer: ReturnType<typeof setTimeout>;
47
+ }
48
+ export interface OAuthTokens {
49
+ ACCESS_TOKEN: string;
50
+ REFRESH_TOKEN?: string;
51
+ EXPIRY_DATE?: string;
52
+ }
53
+ export interface OAuthCallbackResult {
54
+ installationId: string;
55
+ appId: string;
56
+ tenant?: {
57
+ userId: string;
58
+ workspaceId?: string;
59
+ };
60
+ provider: string;
61
+ tokens: OAuthTokens;
62
+ }
63
+ export declare class OAuthManager {
64
+ private pending;
65
+ /**
66
+ * Start a new OAuth flow.
67
+ *
68
+ * Generates a cryptographically random `state`, stores the pending auth
69
+ * entry, and returns the full authorization URL the user should visit.
70
+ */
71
+ startAuth(params: OAuthStartParams): {
72
+ url: string;
73
+ state: string;
74
+ };
75
+ /**
76
+ * Handle an OAuth callback.
77
+ *
78
+ * Validates the state, exchanges the authorization code for tokens,
79
+ * and cleans up the pending entry.
80
+ */
81
+ handleCallback(state: string, code: string): Promise<OAuthCallbackResult>;
82
+ /** Check whether a pending auth exists for the given state. */
83
+ hasPending(state: string): boolean;
84
+ /** Number of active pending auth flows. */
85
+ get pendingCount(): number;
86
+ /** Clean up all pending entries (e.g. on server shutdown). */
87
+ dispose(): void;
88
+ private exchangeCode;
89
+ }
90
+ //# sourceMappingURL=oauth-manager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oauth-manager.d.ts","sourceRoot":"","sources":["../src/oauth-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;CACrB;AAaD,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAkC;IAEjD;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAmCnE;;;;;OAKG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAwB/E,+DAA+D;IAC/D,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAIlC,2CAA2C;IAC3C,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,8DAA8D;IAC9D,OAAO,IAAI,IAAI;YAWD,YAAY;CAgD3B"}
@@ -0,0 +1,148 @@
1
+ /**
2
+ * OAuthManager — server-side OAuth flow for the app station.
3
+ *
4
+ * Manages pending authorization requests and handles the token exchange
5
+ * when the provider redirects back to the app station's public callback
6
+ * endpoint. Supports multiple concurrent users and apps on the same
7
+ * app station instance.
8
+ *
9
+ * Flow:
10
+ * 1. Client calls GET /auth/start → OAuthManager generates the authorize
11
+ * URL and stores a pending entry keyed by a random `state`.
12
+ * 2. User completes consent in the browser → provider redirects to
13
+ * GET /auth/callback?code=X&state=Y.
14
+ * 3. OAuthManager exchanges the code for tokens and returns them so the
15
+ * server can persist them via the SecretsManager.
16
+ */
17
+ import { randomBytes } from 'node:crypto';
18
+ // ---------------------------------------------------------------------------
19
+ // Constants
20
+ // ---------------------------------------------------------------------------
21
+ /** Pending auth entries expire after 10 minutes. */
22
+ const PENDING_TTL_MS = 10 * 60 * 1000;
23
+ // ---------------------------------------------------------------------------
24
+ // OAuthManager
25
+ // ---------------------------------------------------------------------------
26
+ export class OAuthManager {
27
+ pending = new Map();
28
+ /**
29
+ * Start a new OAuth flow.
30
+ *
31
+ * Generates a cryptographically random `state`, stores the pending auth
32
+ * entry, and returns the full authorization URL the user should visit.
33
+ */
34
+ startAuth(params) {
35
+ const state = randomBytes(32).toString('hex');
36
+ // Build the authorization URL
37
+ const url = new URL(params.authorizeUrl);
38
+ url.searchParams.set('client_id', params.clientId);
39
+ url.searchParams.set('response_type', 'code');
40
+ url.searchParams.set('state', state);
41
+ url.searchParams.set('redirect_uri', params.redirectUri);
42
+ if (params.scopes && params.scopes.length > 0) {
43
+ url.searchParams.set('scope', params.scopes.join(' '));
44
+ }
45
+ // Google requires these for a refresh token on first consent.
46
+ if (params.provider.toUpperCase() === 'GOOGLE') {
47
+ url.searchParams.set('access_type', 'offline');
48
+ url.searchParams.set('prompt', 'consent');
49
+ }
50
+ // Auto-expire after TTL
51
+ const timer = setTimeout(() => {
52
+ this.pending.delete(state);
53
+ }, PENDING_TTL_MS);
54
+ this.pending.set(state, {
55
+ params,
56
+ state,
57
+ createdAt: Date.now(),
58
+ timer,
59
+ });
60
+ return { url: url.toString(), state };
61
+ }
62
+ /**
63
+ * Handle an OAuth callback.
64
+ *
65
+ * Validates the state, exchanges the authorization code for tokens,
66
+ * and cleans up the pending entry.
67
+ */
68
+ async handleCallback(state, code) {
69
+ const entry = this.pending.get(state);
70
+ if (!entry) {
71
+ throw new Error('Invalid or expired OAuth state. Please start the authentication again.');
72
+ }
73
+ // Clean up immediately
74
+ clearTimeout(entry.timer);
75
+ this.pending.delete(state);
76
+ const { params } = entry;
77
+ // Exchange code for tokens
78
+ const tokens = await this.exchangeCode(params, code);
79
+ return {
80
+ installationId: params.installationId,
81
+ appId: params.appId,
82
+ tenant: params.tenant,
83
+ provider: params.provider,
84
+ tokens,
85
+ };
86
+ }
87
+ /** Check whether a pending auth exists for the given state. */
88
+ hasPending(state) {
89
+ return this.pending.has(state);
90
+ }
91
+ /** Number of active pending auth flows. */
92
+ get pendingCount() {
93
+ return this.pending.size;
94
+ }
95
+ /** Clean up all pending entries (e.g. on server shutdown). */
96
+ dispose() {
97
+ for (const entry of this.pending.values()) {
98
+ clearTimeout(entry.timer);
99
+ }
100
+ this.pending.clear();
101
+ }
102
+ // -------------------------------------------------------------------------
103
+ // Token exchange
104
+ // -------------------------------------------------------------------------
105
+ async exchangeCode(params, code) {
106
+ const body = new URLSearchParams({
107
+ grant_type: 'authorization_code',
108
+ code,
109
+ redirect_uri: params.redirectUri,
110
+ });
111
+ // Send credentials both in body and as Basic Auth header — some
112
+ // providers expect one, some expect the other. Sending both is safe
113
+ // per RFC 6749 §2.3.1.
114
+ const basicAuth = Buffer.from(`${params.clientId}:${params.clientSecret}`).toString('base64');
115
+ body.set('client_id', params.clientId);
116
+ body.set('client_secret', params.clientSecret);
117
+ const response = await fetch(params.tokenUrl, {
118
+ method: 'POST',
119
+ headers: {
120
+ 'Content-Type': 'application/x-www-form-urlencoded',
121
+ Authorization: `Basic ${basicAuth}`,
122
+ },
123
+ body,
124
+ signal: AbortSignal.timeout(15_000),
125
+ });
126
+ if (!response.ok) {
127
+ const text = await response.text().catch(() => 'unknown error');
128
+ throw new Error(`Token exchange failed: ${response.status} ${text}`);
129
+ }
130
+ const data = (await response.json());
131
+ const accessToken = data.access_token;
132
+ if (!accessToken) {
133
+ throw new Error('Token exchange response missing access_token');
134
+ }
135
+ const refreshToken = data.refresh_token;
136
+ const expiresIn = data.expires_in;
137
+ const expiresAt = typeof expiresIn === 'number'
138
+ ? new Date(Date.now() + expiresIn * 1000).toISOString()
139
+ : undefined;
140
+ const tokens = { ACCESS_TOKEN: accessToken };
141
+ if (refreshToken)
142
+ tokens.REFRESH_TOKEN = refreshToken;
143
+ if (expiresAt)
144
+ tokens.EXPIRY_DATE = expiresAt;
145
+ return tokens;
146
+ }
147
+ }
148
+ //# sourceMappingURL=oauth-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oauth-manager.js","sourceRoot":"","sources":["../src/oauth-manager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * OAuth callback HTML pages.
3
+ *
4
+ * Minimal inline HTML for the browser-facing success and error pages
5
+ * that the user sees after completing (or failing) an OAuth flow.
6
+ */
7
+ export declare function successPage(appName: string, alias?: string): string;
8
+ export declare function errorPage(title: string, detail?: string): string;
9
+ //# sourceMappingURL=oauth-pages.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oauth-pages.d.ts","sourceRoot":"","sources":["../src/oauth-pages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqBH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAanE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAYhE"}
@@ -0,0 +1,59 @@
1
+ /**
2
+ * OAuth callback HTML pages.
3
+ *
4
+ * Minimal inline HTML for the browser-facing success and error pages
5
+ * that the user sees after completing (or failing) an OAuth flow.
6
+ */
7
+ const BASE_STYLE = `
8
+ body {
9
+ font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
10
+ display: flex; justify-content: center; align-items: center;
11
+ min-height: 100vh; margin: 0;
12
+ background: #f8f9fa; color: #1a1a1a;
13
+ }
14
+ .card {
15
+ text-align: center; padding: 3rem 2rem;
16
+ background: #fff; border-radius: 12px;
17
+ box-shadow: 0 2px 12px rgba(0,0,0,0.08);
18
+ max-width: 420px; width: 90%;
19
+ }
20
+ .icon { font-size: 3rem; margin-bottom: 1rem; }
21
+ h1 { font-size: 1.4rem; margin: 0 0 0.5rem; }
22
+ p { color: #555; line-height: 1.5; margin: 0.5rem 0; }
23
+ .subtle { font-size: 0.85rem; color: #999; margin-top: 1.5rem; }
24
+ `;
25
+ export function successPage(appName, alias) {
26
+ const label = alias ? `${appName} (${alias})` : appName;
27
+ return `<!DOCTYPE html>
28
+ <html lang="en">
29
+ <head><meta charset="utf-8"><title>Connected</title>
30
+ <meta name="viewport" content="width=device-width,initial-scale=1">
31
+ <style>${BASE_STYLE}</style></head>
32
+ <body><div class="card">
33
+ <div class="icon">✅</div>
34
+ <h1>${escapeHtml(label)} connected</h1>
35
+ <p>Authentication complete. Your app is ready to use.</p>
36
+ <p class="subtle">You can close this tab.</p>
37
+ </div></body></html>`;
38
+ }
39
+ export function errorPage(title, detail) {
40
+ return `<!DOCTYPE html>
41
+ <html lang="en">
42
+ <head><meta charset="utf-8"><title>Error</title>
43
+ <meta name="viewport" content="width=device-width,initial-scale=1">
44
+ <style>${BASE_STYLE} h1 { color: #c0392b; }</style></head>
45
+ <body><div class="card">
46
+ <div class="icon">❌</div>
47
+ <h1>${escapeHtml(title)}</h1>
48
+ ${detail ? `<p>${escapeHtml(detail)}</p>` : ''}
49
+ <p class="subtle">Close this tab and try again.</p>
50
+ </div></body></html>`;
51
+ }
52
+ function escapeHtml(s) {
53
+ return s
54
+ .replace(/&/g, '&amp;')
55
+ .replace(/</g, '&lt;')
56
+ .replace(/>/g, '&gt;')
57
+ .replace(/"/g, '&quot;');
58
+ }
59
+ //# sourceMappingURL=oauth-pages.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oauth-pages.js","sourceRoot":"","sources":["../src/oauth-pages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;CAiBlB,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,KAAc;IACzD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;IACxD,OAAO;;;;SAIA,UAAU;;;QAGX,UAAU,CAAC,KAAK,CAAC;;;qBAGJ,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,MAAe;IACtD,OAAO;;;;SAIA,UAAU;;;QAGX,UAAU,CAAC,KAAK,CAAC;IACrB,MAAM,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;;qBAE3B,CAAC;AACtB,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC;SACL,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC"}
@@ -0,0 +1,52 @@
1
+ /**
2
+ * Policy evaluation: which effect a Principal's Policy gives a tool call.
3
+ *
4
+ * A Policy is a list of Rules plus a default effect (POLICY-REQ-2). The most
5
+ * specific matching Rule wins, ordered app+tool+when > app+tool > app+* >
6
+ * *+*; among equal specificity the first declared wins; no match means the
7
+ * default effect (POLICY-REQ-3). Annotations never decide on their own: the
8
+ * "sensitive or destructive tools ask" behaviour is two default Rules every
9
+ * new Policy starts with (POLICY-REQ-4).
10
+ */
11
+ import { type PermissionEffect, type Policy } from '@agentapps/protocol';
12
+ /** What a Rule can be evaluated against. */
13
+ export interface ToolCallFacts {
14
+ app: string;
15
+ tool: string;
16
+ args: Record<string, unknown>;
17
+ annotations?: Record<string, unknown>;
18
+ }
19
+ /** The outcome of evaluating a Policy: the effect and the Rule that gave it. */
20
+ export interface PolicyDecision {
21
+ effect: PermissionEffect;
22
+ /** The deciding Rule's id, or `default` when no Rule matched. */
23
+ rule: string;
24
+ }
25
+ /**
26
+ * The Policy every new Principal starts with (POLICY-REQ-2, POLICY-REQ-4):
27
+ * allow by default, ask for destructive and for sensitive tools.
28
+ *
29
+ * @spec POLICY-REQ-4
30
+ */
31
+ export declare function defaultPolicy(principalId: string, now?: string): Policy;
32
+ /**
33
+ * Evaluate a Policy for one tool call.
34
+ *
35
+ * @spec POLICY-REQ-3
36
+ */
37
+ export declare function evaluatePolicy(policy: Policy, call: ToolCallFacts): PolicyDecision;
38
+ /**
39
+ * Whether a tool stays in a Principal's tool list: hidden only when the Policy
40
+ * denies it whatever the arguments.
41
+ *
42
+ * @spec POLICY-REQ-11
43
+ */
44
+ export declare function toolVisible(policy: Policy, app: string, tool: string, annotations?: Record<string, unknown>): boolean;
45
+ /**
46
+ * Whether an Installation of `app` is listed to a Principal: hidden only when
47
+ * the Policy denies the App as a whole.
48
+ *
49
+ * @spec POLICY-REQ-10
50
+ */
51
+ export declare function appVisible(policy: Policy, app: string): boolean;
52
+ //# sourceMappingURL=permission-enforcer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"permission-enforcer.d.ts","sourceRoot":"","sources":["../src/permission-enforcer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,MAAM,EAGZ,MAAM,qBAAqB,CAAC;AAE7B,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,gBAAgB,CAAC;IACzB,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,SAA2B,GAAG,MAAM,CAwBzF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,cAAc,CAalF;AAkDD;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,OAAO,CAUT;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAM/D"}