@ossy/sdk 1.40.1 → 1.40.3

package/README.md

@@ -41,8 +41,8 @@ const resource = await sdk.resources.get({ id: 'resource-id' })
 - `sdk.workspaces.list()` — List workspaces
 - `sdk.workspaces.get({ workspaceId })` — Get workspace by ID
 - `sdk.workspaces.create(payload)` — Create workspace
-- `sdk.workspaces.importResourceTemplates(...)` — Import resource templates
-- `sdk.workspaces.getResourceTemplates(...)` — Get resource templates
+- `sdk.workspaces.importSchemas(...)` — Import schemas
+- `sdk.workspaces.getSchemas(...)` — Get schemas
 
 ### Resources
 
@@ -87,6 +87,26 @@ export const App = () => (
 )
 ```
 
+## Agents (MCP)
+
+MCP is embedded in the app server — same actions as `sdk.invoke`, exposed as tools from `build/capabilities.json`.
+
+```json
+{
+  "mcpServers": {
+    "ossy-local": {
+      "url": "http://localhost:3006/mcp",
+      "headers": {
+        "Authorization": "Bearer your-jwt-token",
+        "workspaceId": "your-workspace-id"
+      }
+    }
+  }
+}
+```
+
+See [TODO-AGENT-MCP.md](../../docs/TODO-AGENT-MCP.md).
+
 ## Invoking platform actions
 
 **Writes and commands** use `sdk.invoke(action, payload)` with a platform action POJO or id string:
@@ -98,8 +118,8 @@ import { BookingCreate } from '@ossy/booking'
 const sdk = SDK.of({ workspaceId: 'your-workspace-id' })
 
 // POJO (preferred) — importable on client and server
-await sdk.invoke(BookingCreate, { consultantId, startAt, duration })
-// HTTP: POST /actions with { action: 'booking/create', payload: { … } }
+await sdk.invoke(BookingCreate, { providerId, startAt, duration })
+// HTTP: POST /actions with { action: '@ossy/booking/actions/create', payload: { … } }
 ```
 
 **Reads** use location paths — not invoke:
@@ -107,3 +127,32 @@ await sdk.invoke(BookingCreate, { consultantId, startAt, duration })
 ```js
 await sdk.resources.list({ location: '/@ossy/booking/services/' })
 ```
+
+## Push invalidation (ADR 0008)
+
+Subscribe to workspace SSE events at `GET /events` to invalidate client read caches when server state changes.
+
+```js
+import { SDK } from '@ossy/sdk'
+
+const sdk = SDK.of({ workspaceId: 'your-workspace-id' })
+
+const unsubscribe = sdk.subscribePush({
+  onMessage: (message) => {
+    // message.invalidate — cache keys to drop (when present)
+    console.log(message.kind, message.invalidate)
+  },
+  onError: (error) => {
+    console.error('SSE error', error)
+  },
+})
+
+// later
+unsubscribe()
+```
+
+`PushMessage` fields include `kind`, `type`, `resourceId`, `event`, `version`, `eventId`, `scope.workspaceId`, and `invalidate` (string array of cache keys).
+
+Requires `workspaceId` on the SDK config, or a workspace cookie on the same origin. Returns a no-op unsubscribe when `EventSource` is unavailable (SSR/tests).
+
+With React, `WorkspaceProvider` from `@ossy/sdk-react` wires this automatically via `usePushInvalidation`.

package/build/public.index.d.ts

@@ -1,15 +1,29 @@
-import { Action, SDKConfig, ActionAccess } from '@ossy/types';
+import { Action, ActionRoute, SDKConfig, ActionAccess } from '@ossy/types';
 export * from '@ossy/types';
-export { ActionAccess, TaskStatus, Tasks } from '@ossy/types';
+export { ActionAccess, ActionRoute } from '@ossy/types';
 
 type ActionRef = Action | string;
-/** Normalize dot aliases to slash ids (`resources.list` → `resources/list`). */
+/** Normalize dot aliases to slash ids (`@ossy.booking.actions.create` → `@ossy/booking/actions/create`). */
 declare function resolveActionId(action: ActionRef): string;
+/**
+ * Resolve POST /actions URL from an SDK `apiUrl`.
+ * Actions are served at the app server root, not under `/api/v0` or the `/@ossy` proxy prefix.
+ */
+declare function resolveActionsUrl(apiUrl: string): string;
+/** Resolve GET /events SSE URL from an SDK `apiUrl`. */
+declare function resolveEventsUrl(apiUrl: string): string;
+
+/**
+ * Resolve a manifest HTTP action route to a fetch URL.
+ * Supports same-origin `/@ossy` proxy and absolute `/api/v0` bases.
+ */
+declare function resolveHttpActionUrl(apiUrl: string, route: ActionRoute, payload?: Record<string, unknown>): string;
 
 declare class SDK {
     workspaceId?: string;
     authorization?: string;
     baseUrl: string;
+    actionRoutes: Record<string, ActionRoute>;
     static of(config: SDKConfig): SDK;
     constructor(config: SDKConfig);
     updateConfig(intendedConfig: SDKConfig): void;
@@ -38,7 +52,28 @@ declare class SDK {
     };
     invoke: <TPayload extends Record<string, unknown> = Record<string, unknown>, TResult = unknown>(action: ActionRef, payload?: TPayload) => Promise<TResult>;
     invokePlatformAction: (actionId: string, payload?: Record<string, unknown>) => Promise<any>;
+    invokeHttpRoute: (route: ActionRoute, payload?: Record<string, unknown>) => Promise<any>;
     handleResponse: (response: Response) => Response | Promise<any>;
+    /**
+     * Subscribe to workspace push invalidation (ADR 0008 §9 SSE).
+     * Requires `workspaceId` on the SDK config (or workspace cookie on same origin).
+     */
+    subscribePush: (handlers: {
+        onMessage: (message: PushMessage) => void;
+        onError?: (error: Event) => void;
+    }) => (() => void);
+}
+interface PushMessage {
+    kind: string;
+    type?: string;
+    resourceId?: string;
+    event?: string;
+    version?: number;
+    eventId?: string;
+    scope?: {
+        workspaceId?: string;
+    };
+    invalidate?: string[];
 }
 
 /** Platform action POJO for CLI discovery and `sdk.invoke` action refs. */
@@ -65,10 +100,10 @@ declare const WorkspacesGet: PlatformAction<{
 declare const WorkspacesCreate: PlatformAction<{
     name: string;
 }>;
-declare const WorkspacesImportResourceTemplates: PlatformAction<{
-    templates: unknown[];
+declare const WorkspacesImportSchemas: PlatformAction<{
+    schemas: unknown[];
 }>;
-declare const WorkspacesGetResourceTemplates: PlatformAction;
+declare const WorkspacesGetSchemas: PlatformAction;
 declare const WorkspacesCreateApiToken: PlatformAction<{
     description: string;
 }>;
@@ -173,5 +208,5 @@ declare const AuthSignOff: PlatformAction;
 /** @deprecated Use `PlatformAction`. */
 type RestAction<TPayload = Record<string, unknown>> = PlatformAction<TPayload>;
 
-export { ApiTokenCreate, ApiTokenGetAll, ApiTokenInvalidate, AuthGetAuthenticatedUser, AuthGetAuthenticatedUserHistory, AuthGetUser, AuthSignIn, AuthSignOff, AuthSignUp, AuthVerifyInvitation, AuthVerifySignIn, ResourceUpdateAccess, ResourcesCreate, ResourcesCreateDirectory, ResourcesGet, ResourcesList, ResourcesMove, ResourcesRemove, ResourcesRename, ResourcesSearch, ResourcesUpdateContent, ResourcesUpload, ResourcesUploadNamedVersion, SDK, UserCurrentGet, UserCurrentGetHistory, UserCurrentUpdate, WorkspacesAddMember, WorkspacesCreate, WorkspacesCreateApiToken, WorkspacesDisableService, WorkspacesEnableService, WorkspacesGet, WorkspacesGetApiTokens, WorkspacesGetCurrent, WorkspacesGetResourceTemplates, WorkspacesGetUsers, WorkspacesImportResourceTemplates, WorkspacesInviteUser, WorkspacesList, WorkspacesRemoveMember, resolveActionId };
-export type { ActionRef, PlatformAction, RestAction };
+export { ApiTokenCreate, ApiTokenGetAll, ApiTokenInvalidate, AuthGetAuthenticatedUser, AuthGetAuthenticatedUserHistory, AuthGetUser, AuthSignIn, AuthSignOff, AuthSignUp, AuthVerifyInvitation, AuthVerifySignIn, ResourceUpdateAccess, ResourcesCreate, ResourcesCreateDirectory, ResourcesGet, ResourcesList, ResourcesMove, ResourcesRemove, ResourcesRename, ResourcesSearch, ResourcesUpdateContent, ResourcesUpload, ResourcesUploadNamedVersion, SDK, UserCurrentGet, UserCurrentGetHistory, UserCurrentUpdate, WorkspacesAddMember, WorkspacesCreate, WorkspacesCreateApiToken, WorkspacesDisableService, WorkspacesEnableService, WorkspacesGet, WorkspacesGetApiTokens, WorkspacesGetCurrent, WorkspacesGetSchemas, WorkspacesGetUsers, WorkspacesImportSchemas, WorkspacesInviteUser, WorkspacesList, WorkspacesRemoveMember, resolveActionId, resolveActionsUrl, resolveEventsUrl, resolveHttpActionUrl };
+export type { ActionRef, PlatformAction, PushMessage, RestAction };

package/build/public.index.js

@@ -1 +1 @@
-const e={VisualContentDescriptors:"@ossy/tasks/visual-content-descriptors",ResizeCommonWeb:"@ossy/tasks/resize-common-web"},s={Queued:"queued",InProgress:"in progress",Success:"success",Failed:"failed"},t={id:"users/get-api-tokens"},i={id:"users/create-api-token"},r={id:"users/invalidate-api-token"},o={id:"workspaces/list"},a={id:"workspaces/get"},n={id:"workspaces/get"},c={id:"workspaces/create"},d={id:"workspaces/import-resource-templates"},u={id:"workspaces/get-resource-templates"},p={id:"workspaces/create-api-token"},h={id:"workspaces/get-api-tokens"},l={id:"workspaces/invite-user"},k={id:"workspaces/enable-service"},g={id:"workspaces/disable-service"},m={id:"workspaces/get-users"},w={id:"users/join-workspace"},y={id:"workspaces/remove-member"},b={id:"authentication/get-current-user"},v={id:"users/get-current-user-history"},f={id:"users/update-details"},j={id:"resources/create",payload:{type:"directory"}},z={id:"resources/create"},U={id:"resources/create"},P={id:"resources/upload-named-version"},I={id:"resources/get"},O={id:"resources/list"},T={id:"resources/search"},C={id:"resources/update-access"},S={id:"resources/delete"},R={id:"resources/update-content"},A={id:"resources/update-location"},q={id:"resources/update-name"},N={id:"authentication/sign-up"},V={id:"authentication/request-sign-in"},$={id:"authentication/verify-sign-in"},x={id:"workspaces/accept-invitation"},D={id:"authentication/get-current-user"},F={id:"users/get-current-user-history"},J={id:"authentication/get-current-user"},L={id:"authentication/sign-out"};function Q(e){const s="string"==typeof e?e:e.id;return s.includes(".")?s.replace(/\./g,"/"):s}class W{static of(e){return new W(e)}constructor(e){this.baseUrl="https://api.ossy.se/api/v0",this.invoke=(e,s)=>this.invokePlatformAction(Q(e),s),this.invokePlatformAction=(e,s)=>{const t={method:"POST",credentials:"include",headers:{"Content-Type":"application/json"},body:JSON.stringify({action:e,payload:null!=s?s:{}})};this.workspaceId&&(t.headers=Object.assign(Object.assign({},t.headers),{workspaceId:this.workspaceId})),this.authorization&&(t.headers=Object.assign(Object.assign({},t.headers),{Authorization:this.authorization}));const i=this.baseUrl.replace(/\/api\/v0\/?$/,"");return fetch(i?`${i}/actions`:"/actions",t).then(this.handleResponse)},this.handleResponse=e=>{const s=e.headers.get("Content-Type")||"",t=e.status;return 400===t?e.json().then(e=>Promise.reject(e.error)):[200,204].includes(t)?s.includes("application/json")?e.json():e:Promise.reject(e)},this.updateConfig(e)}updateConfig(e){this.baseUrl=e.apiUrl||this.baseUrl,this.workspaceId=e.workspaceId||this.workspaceId,this.authorization=e.authorization||this.authorization}get resources(){return{upload:({location:e="/",file:s})=>{const t={type:s.type,location:e,name:s.name,size:s.size};return this.invoke(U,t).then(e=>fetch(e.content.uploadUrl,{method:"PUT",body:s}).then(()=>e))},list:e=>{const s=new URLSearchParams(Object.assign({},e)).toString();return this.invoke(O,{search:s})},uploadNamedVersion:({id:e,name:s,file:t})=>{const i={id:e,name:s,size:t.size};return this.invoke(P,i).then(e=>fetch(e.content.uploadUrl,{method:"PUT",body:t}).then(()=>e))}}}}export{i as ApiTokenCreate,t as ApiTokenGetAll,r as ApiTokenInvalidate,D as AuthGetAuthenticatedUser,F as AuthGetAuthenticatedUserHistory,J as AuthGetUser,V as AuthSignIn,L as AuthSignOff,N as AuthSignUp,x as AuthVerifyInvitation,$ as AuthVerifySignIn,C as ResourceUpdateAccess,z as ResourcesCreate,j as ResourcesCreateDirectory,I as ResourcesGet,O as ResourcesList,A as ResourcesMove,S as ResourcesRemove,q as ResourcesRename,T as ResourcesSearch,R as ResourcesUpdateContent,U as ResourcesUpload,P as ResourcesUploadNamedVersion,W as SDK,s as TaskStatus,e as Tasks,b as UserCurrentGet,v as UserCurrentGetHistory,f as UserCurrentUpdate,w as WorkspacesAddMember,c as WorkspacesCreate,p as WorkspacesCreateApiToken,g as WorkspacesDisableService,k as WorkspacesEnableService,n as WorkspacesGet,h as WorkspacesGetApiTokens,a as WorkspacesGetCurrent,u as WorkspacesGetResourceTemplates,m as WorkspacesGetUsers,d as WorkspacesImportResourceTemplates,l as WorkspacesInviteUser,o as WorkspacesList,y as WorkspacesRemoveMember,Q as resolveActionId};
+const s={VisualContentDescriptors:"@ossy/tasks/visual-content-descriptors",ResizeCommonWeb:"@ossy/tasks/resize-common-web"},e={Queued:"queued",InProgress:"in progress",Success:"success",Failed:"failed"},t={id:"@ossy/users/actions/get-api-tokens"},o={id:"@ossy/users/actions/create-api-token"},i={id:"@ossy/users/actions/invalidate-api-token"},n={id:"@ossy/workspaces/actions/list"},a={id:"@ossy/workspaces/actions/get"},r={id:"@ossy/workspaces/actions/get"},c={id:"@ossy/workspaces/actions/create"},u={id:"@ossy/workspaces/actions/import-schemas"},d={id:"@ossy/workspaces/actions/get-schemas"},h={id:"@ossy/workspaces/actions/create-api-token"},p={id:"@ossy/workspaces/actions/get-api-tokens"},l={id:"@ossy/workspaces/actions/invite-user"},y={id:"@ossy/workspaces/actions/enable-service"},g={id:"@ossy/workspaces/actions/disable-service"},k={id:"@ossy/workspaces/actions/get-users"},v={id:"@ossy/users/actions/join-workspace"},m={id:"@ossy/workspaces/actions/remove-member"},w={id:"@ossy/authentication/actions/get-current-user"},f={id:"@ossy/users/actions/get-current-user-history"},b={id:"@ossy/users/actions/update-details"},j={id:"@ossy/resources/actions/create",payload:{type:"directory"}},$={id:"@ossy/resources/actions/create"},z={id:"@ossy/resources/actions/create"},O={id:"@ossy/resources/actions/upload-named-version"},R={id:"@ossy/resources/actions/get"},S={id:"@ossy/resources/actions/list"},U={id:"@ossy/resources/actions/search"},T={id:"@ossy/resources/actions/update-access"},P={id:"@ossy/resources/actions/delete"},I={id:"@ossy/resources/actions/update-content"},E={id:"@ossy/resources/actions/update-location"},C={id:"@ossy/resources/actions/update-name"},A={id:"@ossy/authentication/actions/sign-up"},W={id:"@ossy/authentication/actions/request-sign-in"},G={id:"@ossy/authentication/actions/verify-sign-in"},H={id:"@ossy/workspaces/actions/accept-invitation"},N={id:"@ossy/authentication/actions/get-current-user"},q={id:"@ossy/users/actions/get-current-user-history"},D={id:"@ossy/authentication/actions/get-current-user"},J={id:"@ossy/authentication/actions/sign-out"};function L(s){const e="string"==typeof s?s:s.id;return e.includes(".")?e.replace(/\./g,"/"):e}function V(s){const e=(null!=s?s:"").replace(/\/$/,"");if(!e||"/@ossy"===e||e.endsWith("/@ossy"))return"/actions";const t=e.replace(/\/api\/v0\/?$/,"").replace(/\/$/,"");return t?`${t}/actions`:"/actions"}function x(s){const e=(null!=s?s:"").replace(/\/$/,"");if(!e||"/@ossy"===e||e.endsWith("/@ossy"))return"/events";const t=e.replace(/\/api\/v0\/?$/,"").replace(/\/$/,"");return t?`${t}/events`:"/events"}function F(s,e,t){var o,i;const n=e.path.startsWith("/")?e.path:`/${e.path}`,a=(null!=s?s:"").replace(/\/$/,"");let r;r=!a||"/@ossy"===a||a.endsWith("/@ossy")?`/@ossy${n.replace(/^\/api\/v0/,"")}`:a.includes("/api/v0")?`${a.replace(/\/api\/v0\/?$/,"")}${n}`:`${a}${n}`;const c=null!==(o=e.method)&&void 0!==o?o:"GET";if("GET"===c||"HEAD"===c){const s=new URLSearchParams;for(const o of null!==(i=e.query)&&void 0!==i?i:[]){const e=null==t?void 0:t[o];null!=e&&""!==e&&s.set(o,String(e))}const o=s.toString();o&&(r+=`${r.includes("?")?"&":"?"}${o}`)}return r}class M{static of(s){return new M(s)}constructor(s){this.baseUrl="https://api.ossy.se/api/v0",this.actionRoutes={},this.invoke=(s,e)=>this.invokePlatformAction(L(s),e),this.invokePlatformAction=(s,e)=>{const t=this.actionRoutes[s];if(t)return this.invokeHttpRoute(t,e);const o={method:"POST",credentials:"include",headers:{"Content-Type":"application/json"},body:JSON.stringify({action:s,payload:null!=e?e:{}})};this.workspaceId&&(o.headers=Object.assign(Object.assign({},o.headers),{workspaceId:this.workspaceId})),this.authorization&&(o.headers=Object.assign(Object.assign({},o.headers),{Authorization:this.authorization}));const i=V(this.baseUrl);return fetch(i,o).then(this.handleResponse)},this.invokeHttpRoute=(s,e)=>{var t;const o=null!==(t=s.method)&&void 0!==t?t:"GET",i=F(this.baseUrl,s,e),n={method:o,credentials:"include",headers:{}};return this.workspaceId&&(n.headers=Object.assign(Object.assign({},n.headers),{workspaceId:this.workspaceId})),this.authorization&&(n.headers=Object.assign(Object.assign({},n.headers),{Authorization:this.authorization})),"GET"!==o&&"HEAD"!==o&&(n.headers=Object.assign(Object.assign({},n.headers),{"Content-Type":"application/json"}),n.body=JSON.stringify(null!=e?e:{})),fetch(i,n).then(this.handleResponse)},this.handleResponse=s=>{const e=s.headers.get("Content-Type")||"",t=s.status;return 400===t?s.json().then(s=>Promise.reject(s.error)):[200,204].includes(t)?e.includes("application/json")?s.json():s:Promise.reject(s)},this.subscribePush=s=>{if("undefined"==typeof EventSource)return()=>{};const e=x(this.baseUrl),t=new EventSource(e,{withCredentials:!0});return t.onmessage=e=>{try{const t=JSON.parse(e.data);s.onMessage(t)}catch(s){}},t.onerror=e=>{var t;null===(t=s.onError)||void 0===t||t.call(s,e)},()=>{t.close()}},this.updateConfig(s)}updateConfig(s){var e;this.baseUrl=s.apiUrl||this.baseUrl,this.workspaceId=s.workspaceId||this.workspaceId,this.authorization=s.authorization||this.authorization,this.actionRoutes=null!==(e=s.actionRoutes)&&void 0!==e?e:this.actionRoutes}get resources(){return{upload:({location:s="/",file:e})=>{const t={type:e.type,location:s,name:e.name,size:e.size};return this.invoke(z,t).then(s=>fetch(s.content.uploadUrl,{method:"PUT",body:e}).then(()=>s))},list:s=>{const e=new URLSearchParams(Object.assign({},s)).toString();return this.invoke(S,{search:e})},uploadNamedVersion:({id:s,name:e,file:t})=>{const o={id:s,name:e,size:t.size};return this.invoke(O,o).then(s=>fetch(s.content.uploadUrl,{method:"PUT",body:t}).then(()=>s))}}}}export{o as ApiTokenCreate,t as ApiTokenGetAll,i as ApiTokenInvalidate,N as AuthGetAuthenticatedUser,q as AuthGetAuthenticatedUserHistory,D as AuthGetUser,W as AuthSignIn,J as AuthSignOff,A as AuthSignUp,H as AuthVerifyInvitation,G as AuthVerifySignIn,T as ResourceUpdateAccess,$ as ResourcesCreate,j as ResourcesCreateDirectory,R as ResourcesGet,S as ResourcesList,E as ResourcesMove,P as ResourcesRemove,C as ResourcesRename,U as ResourcesSearch,I as ResourcesUpdateContent,z as ResourcesUpload,O as ResourcesUploadNamedVersion,M as SDK,e as TaskStatus,s as Tasks,w as UserCurrentGet,f as UserCurrentGetHistory,b as UserCurrentUpdate,v as WorkspacesAddMember,c as WorkspacesCreate,h as WorkspacesCreateApiToken,g as WorkspacesDisableService,y as WorkspacesEnableService,r as WorkspacesGet,p as WorkspacesGetApiTokens,a as WorkspacesGetCurrent,d as WorkspacesGetSchemas,k as WorkspacesGetUsers,u as WorkspacesImportSchemas,l as WorkspacesInviteUser,n as WorkspacesList,m as WorkspacesRemoveMember,L as resolveActionId,V as resolveActionsUrl,x as resolveEventsUrl,F as resolveHttpActionUrl};

package/build/types/Actions.d.ts

@@ -23,10 +23,10 @@ export declare const WorkspacesGet: PlatformAction<{
 export declare const WorkspacesCreate: PlatformAction<{
     name: string;
 }>;
-export declare const WorkspacesImportResourceTemplates: PlatformAction<{
-    templates: unknown[];
+export declare const WorkspacesImportSchemas: PlatformAction<{
+    schemas: unknown[];
 }>;
-export declare const WorkspacesGetResourceTemplates: PlatformAction;
+export declare const WorkspacesGetSchemas: PlatformAction;
 export declare const WorkspacesCreateApiToken: PlatformAction<{
     description: string;
 }>;

package/build/types/index.d.ts

@@ -1,2 +1,2 @@
 export * from "./sdk.js";
-export { Tasks, TaskStatus } from "./tasks-client.js";
+export { Tasks, TaskStatus } from "@ossy/types";

package/build/types/platform-action.d.ts

@@ -1,5 +1,12 @@
 import type { Action } from '@ossy/types';
 export type ActionRef = Action | string;
 export declare function isActionRef(value: unknown): value is ActionRef;
-/** Normalize dot aliases to slash ids (`resources.list` → `resources/list`). */
+/** Normalize dot aliases to slash ids (`@ossy.booking.actions.create` → `@ossy/booking/actions/create`). */
 export declare function resolveActionId(action: ActionRef): string;
+/**
+ * Resolve POST /actions URL from an SDK `apiUrl`.
+ * Actions are served at the app server root, not under `/api/v0` or the `/@ossy` proxy prefix.
+ */
+export declare function resolveActionsUrl(apiUrl: string): string;
+/** Resolve GET /events SSE URL from an SDK `apiUrl`. */
+export declare function resolveEventsUrl(apiUrl: string): string;

package/build/types/public.index.d.ts

@@ -1,4 +1,3 @@
-export { Tasks, TaskStatus } from './tasks-client.js';
 export * from '@ossy/types';
 export * from './sdk';
 export * from './Actions';

package/build/types/resolve-http-action-url.d.ts

@@ -0,0 +1,6 @@
+import type { ActionRoute } from '@ossy/types';
+/**
+ * Resolve a manifest HTTP action route to a fetch URL.
+ * Supports same-origin `/@ossy` proxy and absolute `/api/v0` bases.
+ */
+export declare function resolveHttpActionUrl(apiUrl: string, route: ActionRoute, payload?: Record<string, unknown>): string;

package/build/types/sdk.d.ts

@@ -1,10 +1,14 @@
 import { SDKConfig } from './config';
-import { resolveActionId, type ActionRef } from './platform-action';
-export { resolveActionId, type ActionRef };
+import { resolveActionId, resolveActionsUrl, resolveEventsUrl, type ActionRef } from './platform-action';
+import { resolveHttpActionUrl } from './resolve-http-action-url';
+import type { ActionRoute } from '@ossy/types';
+export { resolveActionId, resolveActionsUrl, resolveEventsUrl, resolveHttpActionUrl, type ActionRef };
+export type { ActionRoute };
 export declare class SDK {
     workspaceId?: string;
     authorization?: string;
     baseUrl: string;
+    actionRoutes: Record<string, ActionRoute>;
     static of(config: SDKConfig): SDK;
     constructor(config: SDKConfig);
     updateConfig(intendedConfig: SDKConfig): void;
@@ -33,5 +37,26 @@ export declare class SDK {
     };
     invoke: <TPayload extends Record<string, unknown> = Record<string, unknown>, TResult = unknown>(action: ActionRef, payload?: TPayload) => Promise<TResult>;
     invokePlatformAction: (actionId: string, payload?: Record<string, unknown>) => Promise<any>;
+    invokeHttpRoute: (route: ActionRoute, payload?: Record<string, unknown>) => Promise<any>;
     handleResponse: (response: Response) => Response | Promise<any>;
+    /**
+     * Subscribe to workspace push invalidation (ADR 0008 §9 SSE).
+     * Requires `workspaceId` on the SDK config (or workspace cookie on same origin).
+     */
+    subscribePush: (handlers: {
+        onMessage: (message: PushMessage) => void;
+        onError?: (error: Event) => void;
+    }) => (() => void);
+}
+export interface PushMessage {
+    kind: string;
+    type?: string;
+    resourceId?: string;
+    event?: string;
+    version?: number;
+    eventId?: string;
+    scope?: {
+        workspaceId?: string;
+    };
+    invalidate?: string[];
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ossy/sdk",
   "description": "Software Development Kit for interacting with our services",
-  "version": "1.40.1",
+  "version": "1.40.3",
   "url": "git://github.com/ossy-se/packages/sdk",
   "source": "src/public.index.ts",
   "main": "build/public.index.js",
@@ -21,7 +21,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@ossy/types": "^1.40.1"
+    "@ossy/types": "^1.40.3"
   },
   "scripts": {
     "start": "",
@@ -36,5 +36,5 @@
     "/build",
     "README.md"
   ],
-  "gitHead": "c0ba5d90749690634e4dc2705178ff8d89dd3070"
+  "gitHead": "a0d89185a17f8de8ce328c3a648c108ff1d61d8f"
 }

package/build/types/tasks-client.d.ts

@@ -1,32 +0,0 @@
-import { Tasks, TaskStatus, TaskType, Resource, Task } from '@ossy/types';
-export { Tasks, TaskStatus };
-interface ResourcesClient {
-    search: (payload: Record<string, unknown>) => Promise<Resource<Task>[]>;
-    create: (data: {
-        type: string;
-        location: string;
-        name: string;
-        content: {
-            resourceId: string;
-            status: string;
-            result: undefined;
-        };
-    }) => Promise<Resource<Task>>;
-}
-interface TasksClientConfig {
-    http?: unknown;
-    resources: ResourcesClient;
-}
-export declare class TasksClient {
-    static location: string;
-    private http?;
-    private resources;
-    static of(config: TasksClientConfig): TasksClient;
-    constructor(config: TasksClientConfig);
-    get(_query?: string | Record<string, unknown>): Promise<Resource<Task>[]>;
-    getUnprocessed(): Promise<Resource<Task>[]>;
-    create({ type, resourceId }: {
-        type: TaskType;
-        resourceId: string;
-    }): Promise<Resource<Task>>;
-}