SDKs

TypeScript

Package source: packages/agent-api-sdk. Node.js 20 or newer.

import { FullnessClient } from '@fullness/agent-api';

const fullness = new FullnessClient({
  accessToken: process.env.FULLNESS_ACCESS_TOKEN,
});

const action = await fullness.execute(
  'get_spending_summary',
  { period: 'last_30_days' },
);

console.log(action.result, action.action.activityUrl);

Python

Package source: sdks/python/fullness-agent. Python 3.10 or newer; zero runtime dependencies.

from fullness_agent import FullnessClient

client = FullnessClient(access_token=os.environ["FULLNESS_ACCESS_TOKEN"])
action = client.execute(
    "get_spending_summary",
    {"period": "last_30_days"},
)
print(action["result"])

SDK safety behavior

• Neither SDK approves an action.
• Neither SDK retries a write automatically.
• The caller owns stable idempotency-key generation.
• API errors preserve HTTP status, Fullness error code and response payload.
• The TypeScript SDK can verify webhooks against the raw body.

Raw HTTP is always canonical

The OpenAPI document and OAuth metadata are the source of truth. If an SDK version lags the live contract, use the versioned HTTP routes and report the mismatch.