@native-marketing/sdk 0.2.0 → 0.3.1

package/README.md

@@ -1,49 +0,0 @@
-# @native-marketing/sdk
-
-Node.js 24 authenticated clients for Native Marketing. No database access, server installation, planner or Runtime.
-
-```sh
-npm install @native-marketing/sdk
-```
-
-```ts
-import { withNativeAgentClient, NativeAgentClientError } from '@native-marketing/sdk';
-
-const resource = process.env.CF_AGENT_RESOURCE;
-const accessToken = process.env.CF_AGENT_ACCESS_TOKEN;
-if (!resource || !accessToken) throw new Error('Configure resource-bound OAuth credentials');
-
-await withNativeAgentClient({ resource, accessToken }, async (native) => {
-  const page = await native.discoverCapabilities({ query: '检查连接状态和当前项目' });
-  const item = page.items[0];
-  if (!item) return; // NO_MATCH applies to the currently authorized catalogue.
-  const exact = await native.describeCapability(item.name, item.schemaSha256);
-  const context = await native.readCapability({
-    name: item.name,
-    expectedSchemaSha256: exact.schemaSha256,
-    arguments: {},
-    delivery: 'ORIGINAL',
-  });
-  console.log(context);
-});
-```
-
-The server filters discovery using current object, OAuth scopes and business permissions. `discoverCapabilities` uses AGENT_V3 bilingual action/object matching and explicit scoped NO_MATCH. Small results include the exact schema and fingerprint; `describeCapability(name, observedHash)` reuses a verified, bounded connection-local cache or loads the definition on demand. Every execution still checks current authorization and the fingerprint. The existing `findCapabilities` retains its v2 response contract. Search saved business content with `searchBusiness`; use `getBusinessSummary` for a bounded summary and nextActions. Ordinary collaboration and explicitly assigned execution remain separate.
-
-Writes retain exact schema fingerprints, request IDs, human decisions and optimistic concurrency. On `NativeAgentClientError` inspect `code`, `outcome` and `details`. An UNKNOWN outcome is not a rollback: follow the returned original receipt lookup using the same resource and current authorization. Never automatically retry writes, replace the request ID or infer success from the latest document. Refresh current business content separately after recovering the original result.
-
-Credentials belong in a protected credential store, never model prompts or arguments. This package does not acquire or widen permissions on import. Node.js 24 is required by the MCP client.
-
-## HTTP client
-
-```ts
-import { createContentFactoryClient } from '@native-marketing/sdk/http';
-
-const native = createContentFactoryClient({ baseUrl: 'https://ip.shipkitx.com/api/v1' });
-// A browser uses its existing authorized session. Node callers must provide an
-// authenticated fetch implementation; a base URL alone does not authenticate.
-```
-
-The `/http` entry contains the existing typed HTTP client, validators and generated endpoint types; it does not import the Node MCP/CLI implementation. It does not retry writes or manage browser sessions for Node callers.
-
-The package's `release.json` records the actual source commit and generated API-types hash. This is a local build receipt, not CI provenance or proof that every remote business journey has been accepted. Rights reserved; public package availability does not grant an open-source license (UNLICENSED).