Description

n8n-nodes-lifespace

Official n8n community nodes for integrating workflows and AI agents with LifeSpace.

Install in n8n

The npm package is:

n8n-nodes-lifespace

Self-hosted n8n: install from the UI

You must be an n8n instance Owner or Admin.

1. Open Settings → Community Nodes.
2. Select Install.
3. Enter:

   n8n-nodes-lifespace
   

4. Confirm the community-node warning.
5. Select Install.
6. Return to a workflow and search for LifeSpace.

To pin a release, use for example:

[email protected]

Self-hosted n8n: manual npm installation

mkdir -p ~/.n8n/nodes
cd ~/.n8n/nodes
npm install n8n-nodes-lifespace

Restart n8n afterwards. In queue mode, install the package anywhere that may execute workflows.

Quick start

LifeSpace exposes separate Service, Agent, and Webhook-signing credentials in n8n.

For ordinary owner-controlled automation, create a LifeSpace Service API credential containing:

• API Base URL — the LifeSpace Core API root;
• Service API Token — an opaque lspsvc* token.

This is the normal scheduled/system workflow mode where Principal = Actor = Service. Existing lsppat* tokens remain accepted by LifeSpace only as migration credentials until they are rotated or revoked.

For AI Agent execution, create a LifeSpace Agent API credential containing only:

• API Base URL — the LifeSpace Core API root;
• Agent API Credential — an opaque lspagt* credential.

The adapter no longer asks for an Identity API URL, an lsa Application credential, or a separate agt Agent ID. The lspagt* credential already authenticates the current Application + Agent Actor to Core.

Agent execution has two authority profiles:

Direct Agent
  lspagt* -> Principal=Agent / Actor=Agent
  -> uses only the Agent's own current Data Grant / model authority
User Delegation
  lspagt + explicit dlg_
  -> Principal=User / Actor=Agent
  -> Core resolves and rechecks the current Delegation chain

An Agent API credential never grants User authority by itself. When a LifeSpace Agent Tool lacks sufficient direct Agent authority, it returns a structured authorizationRequired scope. LifeSpace Request Authorization can create or reuse a pending arq request from that exact scope. Confirming the request issues the required independent dlg Delegation(s) atomically after current User authority is rechecked.

The authorization node surface is:

• LifeSpace Request Authorization — AI Tool; creates/reuses a pending request but grants no authority;
• LifeSpace Confirm Authorization — workflow node;
• LifeSpace Confirm Authorization Tool — AI Tool for Human Review flows;
• LifeSpace Deny Authorization — workflow node for an explicit user rejection;
• LifeSpace Cancel Authorization — workflow node;
• LifeSpace Cancel Authorization Tool — AI Tool when the Agent no longer needs the request.

The trusted Principal User ID on Request Authorization is workflow configuration and is never exposed as an AI Tool argument. Runtime represented execution uses the explicit dlg_*; the adapter does not send an arbitrary principalUserId to Core.

Credentials are secrets. Store them only in n8n credentials; do not put lspsvc, legacy lsppat, lspagt, lsa_, Agent JWTs, or signing secrets in workflow fields, URLs, source files, or workflow exports.

A LifeSpace Trigger additionally uses a LifeSpace Webhook Signing credential containing the endpoint-scoped HMAC signing secret. This is deliberately separate from the Service API credential: the Service API Token authenticates outbound n8n → LifeSpace API calls and Runtime Discovery, while the signing secret verifies inbound LifeSpace → n8n deliveries and rotates with its Webhook Endpoint.

Runtime Discovery determines which Spaces, Record Types, fields, queries, Actions, and relation lookup capabilities the current execution context can use. Human workflow nodes use the Service API credential. Agent nodes use the Agent API credential. Execution authorization is always enforced by LifeSpace from verified Application / Principal / Actor context, credential scope, Application × Model Access, current Space/Data Grant authority, published model semantics, and the explicitly selected Delegation when represented User authority is used.

Generated Record UX

The package deliberately exposes two different projections over the same LifeSpace Runtime Discovery semantics:

• LifeSpace is the human-authored workflow node. Create/Update scalar and relation fields are generated through n8n Resource Mapper from the selected Record Type. Writable temporal_range fields are projected directly as three adjacent controls named from the field itself, for example When · Type / When · Start / When · End; there is no redundant Field selector and no raw object/JSON entry. List / Query exposes semantic predicates instead of asking the workflow author to choose a filter type first. Multi-value relations keep their dedicated multi-select UX.
• LifeSpace Agent Tool is the native AI Tool surface. Its schema is generated from Runtime Discovery at design time and pinned into the saved workflow for Query/Create/Update/Delete/Action; workflow execution does not re-run Discovery. AI-facing values stay semantic: temporal_range uses one { kind, start, end } object, relation fields accept { name } / { id } references, and Canonical Query exposes semantic field / operator / value predicates. The adapter resolves names through the field’s published relation lookup, injects the effective n8n workflow timezone when TemporalRange semantics require it, and lowers everything to the canonical LifeSpace transport.

The human workflow node is not exposed through usableAsTool; this avoids maintaining two competing Agent Tool surfaces with different schema behavior.

The Agent Tool never asks the user for internal relation IDs when the conversation already supplies a human label. For example, an Event create call may use attendeePersonIds: [{ "name": "Alice" }]; the adapter performs the authorized source-field relation lookup and sends the resolved stable ID to Core. Ambiguous or missing labels are returned to the Agent as structured errors instead of choosing a target. Stable IDs remain accepted when already known.

Agent-facing TemporalRange values deliberately use Human end semantics: { "kind": "date", "start": "2026-09-20", "end": "2026-09-22" } means an inclusive date end and is lowered to Core’s endExclusive=2026-09-23; kind=instant uses absolute RFC3339 start/end values. Query local-date windows may likewise use inclusive endDate; Canonical Query receives endDateExclusive plus the effective workflow timezone.

For Update/Delete/Action, the Agent Tool still requires a stable recordId. If it is not already known, the Agent should call the matching Query Tool first; the mutation Tool does not guess which record the user meant.

The node displays the authorized human-readable spaceName when present while continuing to submit the stable spc_* ID.

For the human LifeSpace workflow node and Trigger composition, Record Type is the LifeSpace modelKey (for example task). Design-time options, expressions, Trigger output and downstream Record nodes use that plain value. CRUD calls go directly to /spaces/{spaceId}/models/{modelKey}/records/..., so execution adds no Discovery request and the adapter maintains no modelKey-to-route mapping. Existing lsrt1... workflow values are decoded only as a deprecated read-compatibility path and are never emitted or written by new configuration. The native LifeSpace Agent Tool deliberately treats Record Type as a structural design-time choice and stores a private pinned semantic snapshot behind that selection; the user-facing choice still displays the LifeSpace Record Type.

Current Calendar models expose the canonical capabilityBindings.calendar.rangeField role, which points at one authoritative temporalrange field (for example Event v6 when). Historical split-field Calendar bindings remain readable only for already-published compatibility models. Date-only values are normalized to YYYY-MM-DD; ordinary instant fields use the n8n date-time control. Create/Update temporalrange fields use direct Discovery-generated component controls. All Day / Date stores { kind: "date", start, endExclusive } and treats the Human End date as inclusive, while Date & Time stores { kind: "instant", start, endExclusive } from the date-time controls. Existing stored workflows that already contain canonical object values or the earlier pre-release Temporal Ranges fixedCollection remain executable. Create/Update execution does not fetch fresh semantic Discovery solely to produce an adapter-local Calendar conflict error; the canonical mutation goes directly to LifeSpace Core, which remains authoritative for Calendar validation and current authorization.

LifeSpace contract compatibility

This package’s supported n8n adapter surfaces are aligned to LifeSpace Core Kernel 0.53.0 on main; ordinary-model semantics remain Discovery-driven and are pinned by the published model schema hash, not inferred from the Kernel version. Integration/Eventing is independently versioned at 0.3.0. This compatibility declaration describes source-level integration and regression coverage, not proof that all Core capabilities or every environment’s latest migrations are deployed. See 0.2.10 compatibility notes.

The current authority model separates verified Application / Principal / Actor context, supports Agent-as-Principal and bounded Delegation chains, and requires an explicit current dlg_* whenever an Agent executes under represented User authority. The adapter consumes the platform contract; it does not mint its own represented-user tokens or maintain a second authorization state.

The UX depends on these Kernel capabilities:

• 0.18.0: cross-Space current-principal Runtime Discovery at GET /api/v1/me/_discovery;
• 0.19.0: authoritative server defaults exposed in Runtime Discovery;
• 0.20.0: Action semantic input separated from optimistic-concurrency metadata;
• 0.21.0: invitation-token transport hardening retained by the current baseline;
• 0.22.0: authoritative field title metadata plus ordered repeatable Generic Query sort metadata;
• 0.23.0: authorized source-field-aware Relation Target Lookup for person / person_list fields;
• 0.24.0: authorized human-readable spaceName projection while spaceId remains stable;
• 0.25.0: bounded Capability field-role bindings, beginning with Calendar;
• 0.26.0: progressively loadable single-model static semantic detail;
• 0.27.0: compact current-principal inventory that de-duplicates model semantics from Space visibility edges;
• 0.28.0: bounded batch Reference Resolution for relation IDs;
• 0.29.0: canonical ordinary-record referenceLabel semantics plus record / record_list lookup and resolution;
• 0.30.0: explicit paginated Change History collection and Model Control Plane ownership split;
• 0.31.0: Integration/Eventing wire representation moves to the independent Integration/Eventing 0.1.0 contract while Core remains the Runtime authority;
• 0.32.0: modelKey becomes the sole Runtime address and canonical CRUD/Action paths move under /models/{modelKey}/records;
• 0.33.0: canonical structural timeRanges become available in progressive semantic detail without implying an overlap query API;
• 0.34.0: explicit eq/lt/lte/gt/gte comparison transports, first-class createdAt / updatedAt envelope comparisons and Core-owned datetime local-date-window conversion become discoverable;
• 0.35.0: grouped query.capabilityQueries introduced capability-owned compatibility queries;
• 0.36.0: query.canonical unifies Search, typed Boolean Filter, multi-Sort and cursor Pagination behind POST .../records/query; Runtime Discovery also exposes canonical instant, range, range, temporal_range field types and the Calendar rangeField binding;
• 0.40.0: Authority v2 separates verified Application / Principal / Actor from the explicit opaque Delegation selector and adds first-class atomic POST /spaces/{spaceId}/models/batch for 1-20 create/update/delete operations;
• 0.43.0: atomic POST /spaces/{spaceId}/delegations/batch materializes 1-20 independent Delegations for one confirmed business intent;
• 0.44.0: first-class opaque lspagt* Agent API credentials authenticate Application + Agent Actor directly at Core;
• 0.45.0: transport-independent arq_* Authorization Request lifecycle with request/confirm/deny/cancel and atomic Delegation materialization;
• 0.46.0: first-class non-atomic POST /spaces/{spaceId}/models/bulk with independent per-item outcomes and blk correlation, while /models/batch remains the atomic cgs ChangeSet profile.
• 0.47.0: first-class Space Person Directory CRUD, search and alternate-name updates; n8n exposes a dedicated Person resource in both Workflow and Agent Tool.
• 0.49.0: configuration-time Model Semantic Discovery without requiring a Space Data Grant or Delegation; execution still rechecks current Authority.
• 0.51.0: recurrencerule and entityref use the Discovery-published structured valueSchema, rather than an n8n-owned schema.
• 0.52.0: Native/External model discovery union; External models remain bound to a source Space and the current Provider capability ceiling.
• 0.53.0: current Core Kernel compatibility baseline, with existing Person Directory and Canonical Query semantics retained.

The adapter prefers the 0.27+ progressive flow while configuring a node:

GET /me/_discovery/inventory
  -> choose current Space / Record Type
  -> GET /spaces/{spaceId}/_discovery/models/{modelKey}
  -> relation target lookup / reference resolution only when needed
  -> persist stable workflow configuration

Design-time callbacks prefer n8n editor-current parameters, so Fields and Actions refresh immediately after Record Type selection. A legacy 0.1.3 modelRoute remains readable only for the four previously deployed baseline models; re-selecting Record Type writes the plain modelKey.

Execution is deliberately narrower. Get/List/Create/Update/Delete and Execute Action perform no Runtime Discovery preflight. Execute Action pins the selected Action’s semantic input and concurrency contract when the workflow is authored, then uses that saved contract plus the current-record read required for optimistic concurrency. The native Agent Tool likewise reconstructs its Tool schema from its saved semantic snapshot with zero execution-time Discovery. No saved semantic snapshot is treated as authorization proof; every business request still goes through canonical LifeSpace Core current-state enforcement.

The legacy aggregate GET /me/_discovery remains an intentional design-time compatibility fallback. Neither cached Discovery nor relation lookup is treated as authorization proof; every mutation still goes through canonical LifeSpace Runtime enforcement.

Ordinary Record CRUD/Action routes remain model-contract surfaces derived from published Model Definitions; the n8n adapter does not maintain a second copy of those schemas.

Location field and schema migration / 位置字段与迁移

As of n8n-nodes-lifespace 0.2.10, when the target LifeSpace environment publishes a location field (such as the migrated Event model), Workflow Create/Update exposes the canonical structured object through the Resource Mapper; Agent Tools reuse the Core valueSchema. Canonical Query supports withinDistance (WGS84 point + meters), isNull and isNotNull. A place name alone is not geocoded or assigned inferred coordinates by the adapter. A saved Agent Tool pins the selected Model Discovery snapshot; after a breaking model migration, reselect or refresh the Record Type/Tool before using the new field.

Canonical Query

New Workflow and Agent configurations expose one query model:

• Search is a top-level retrieval facet when the selected Record Type publishes searchable fields.
• Filters expose Filter Groups. Each group has its own Match: All / Any and vertically stacked Field, Operator, and string/expression Value controls; multiple groups compose with AND. Field choices come from Discovery, and Operator choices reload from the selected field using n8n’s row-relative dynamic-option dependency.
• Temporal range Overlaps is projected for human workflows as paired Overlaps Start + Overlaps End conditions in the same group. The adapter validates the pair and lowers it to one canonical overlaps range predicate. Date pairs use the current n8n workflow timezone unless Options → Viewing Timezone overrides it.
• Sorts come from query.canonical.sort.fields and preserve user priority.
• Return All, Limit, and the optional opaque Cursor use canonical cursor pagination.

Execution sends POST /spaces/{spaceId}/models/{modelKey}/records/query with a structured body. The current UI does not expose Standard Query, Capability Query, or transport parameter names. Stored workflows that explicitly selected a legacy Capability Query remain executable through a hidden compatibility path, but new configurations cannot create that split.

Expressions and variables

Runtime/business inputs follow normal n8n expression behavior. A value that can be entered or selected in the node can also be supplied through an n8n expression unless it is deliberately a structural control.

Examples:

{{$json.spaceId}}
{{$json.recordId}}
{{$json.recordType}}
{{$vars.lifeSpaceRecordType}}

Discovery-backed runtime selectors such as Space and Sort Field support the normal n8n pattern: choose a value from the list, or switch the parameter to an expression and provide the corresponding stable ID/key. Record Type on the human workflow node stores the plain LifeSpace modelKey, so a LifeSpace Trigger can feed a Record node directly without a mapping step or an extra Discovery request. Action is intentionally structural: selecting it pins the Action input/concurrency contract at design time, so it is reselected rather than supplied dynamically by an expression.

The same applies to ordinary values such as Record ID, Search, Return All, Limit, Sort Direction, Cursor, explicit Version, API Method, API Path and JSON Body.

Two boundaries are intentional:

• Resource and Operation are structural node controls and do not accept expressions because they determine which parameter schema and execution path the node has.
• Fields, Temporal Ranges, and Action Input remain generated from Runtime Discovery. Scalar/relation CRUD fields stay in Resource Mapper; writable temporal_range CRUD fields use the dedicated form. Filters use Discovery-backed field/operator selectors plus string/expression values so Boolean grouping does not depend on dynamically changing n8n value-control types.

For List / Query, Filters is a Discovery-driven group builder. There are no separate top-level Match or Conditions surfaces: every condition belongs to a Filter Group, each group chooses All/Any, and groups are ANDed together. Conditions use the same vertical layout as n8n’s Data Table filters: Field, then Operator, then Value. Changing Field reloads only the operators published for that field. Scalar values remain text or n8n expressions and are deterministically converted back to canonical typed values before the request.

Filter Value is a string-oriented Human UI boundary, not a string-only runtime contract. Expression results are normalized from their n8n runtime type before the Canonical Query request: booleans stay boolean; numbers/integer values accept native numbers or numeric strings; date filters accept date strings plus JS Date / Luxon-like DateTime values; instant/datetime filters accept absolute RFC3339 strings plus JS Date / Luxon-like DateTime values; legacy multi-value in accepts arrays or comma-separated strings. Relation contains remains a single-ID predicate and accepts either an ID string or an object carrying an id string; arrays are rejected so the adapter does not silently invent contains-any semantics.

For TemporalRange fields, the human projection does not ask for JSON. Canonical overlaps is split into Overlaps Start and Overlaps End inputs; they must appear once each in the same Filter Group and are lowered back to one canonical overlaps predicate. Human date End values are inclusive, so the adapter converts them to Core’s exclusive end boundary. before and after accept a single date or absolute RFC3339 date-time string. contains remains executable for stored workflows but is not offered in the new Human UI until it has an equally simple structured projection. Options → Viewing Timezone is optional; TemporalRange date interpretation and sorting fall back to the effective n8n workflow timezone when it is omitted. Sorts remains an ordered structural list because sort priority is part of workflow structure rather than per-item data.

If Record Type itself varies per input item and those Record Types have different schemas, one discovery-generated mapper cannot safely represent every possible schema at design time. In that case, branch to separate LifeSpace nodes per schema or use API Request for a deliberately fully dynamic request.

A Trigger has no upstream input item. Trigger parameters can still use stable n8n variables/expressions, but should not rely on previous-item $json data. Because LifeSpace Webhook Endpoint/Event Subscription configuration is external to the Trigger today, variable-driven Trigger filters should remain stable with that external subscription configuration.

Credentials are intentionally static secure configuration and are not workflow-expression inputs.

Use the LifeSpace node

The normal n8n-facing resource is Record. LifeSpace still owns Model semantics internally; the adapter uses Record Type for the workflow-facing selection.

Supported human Workflow operations include ordinary Record CRUD/Query/Action.

For Create / Update / Delete, Batch Processing is an independent transport/performance option under Record Options and defaults On:

• Batch Processing = On, Atomic Consistency = Off — the default. The node sends one bounded non-atomic LifeSpace Bulk request for 1-20 input items. Each item has an independent result, so valid items may succeed while invalid/stale/unauthorized items fail.
• Batch Processing = On, Atomic Consistency = On — the node sends one atomic LifeSpace Batch request. The whole batch commits or rolls back together and successful commit returns one shared changeSetId.
• Batch Processing = Off — the node returns to per-item execution.

The human Record node is structurally pinned to one Space and one Record Type, so its Batch Processing surface batches incoming items for that selected model. It does not expose a separate mixed-model JSON Batch UI in 0.2.0.

Update/Delete Version remains optional in all modes. In per-item mode, omission keeps the historical behavior of reading the current record immediately before mutation. In Bulk/Batch Processing, omission is sent to Core for set-wise current-version resolution, avoiding an N-read HTTP waterfall.

The native Agent Tool supports Query/Create/Update/Delete/Action plus Create Records (Batch) for 1-20 records of its pinned Record Type. Agent Batch Create remains atomic; Agent Update/Delete are ordinary single-record Tool operations in this release.

Ordinary Record operations remain:

• Create;
• Get;
• List / Query;
• Update;
• Delete;
• Execute Action.

Choose Space and Record Type

For Record operations:

1. choose a Space from compact Runtime Discovery inventory;
2. choose a Record Type available in that Space;
3. configure the operation; the selected model’s semantic detail is loaded only when required.

You normally do not type Space IDs or model keys manually.

Create

Writable fields are generated from Runtime Discovery.

LifeSpace server defaults are authoritative. A field that is required but has a declared server default is not required from the n8n user. Read-only state owned by a LifeSpace Action/Capability is not exposed as a normal Create/Update field.

For example, lifecycle state such as Task status can remain server/Action-owned instead of being manually entered by the workflow author.

Writable temporal_range fields are not shown as generic object controls and do not require choosing the same field again. Runtime Discovery expands each field directly into three adjacent controls. For Event, the UI is:

When · Type
When · Start
When · End

Type chooses All Day / Date or Date & Time. Start and End use n8n date-time controls. For All Day / Date, only the calendar date is used and End is inclusive in the UI; the adapter converts it to LifeSpace’s exclusive end boundary. For Date & Time, End must be later than Start.

This projection is adapter-only; the three controls are combined back into one canonical LifeSpace when value before execution.

When Runtime Discovery advertises relation semantics, supported single-value person / record fields are rendered as selectors from the current authorized { id, label } target projection. Multi-value relations retain the dedicated multi-select control rather than falling back to n8n Resource Mapper’s generic JSON array editor. The displayed value is the canonical LifeSpace reference label, while the workflow payload still stores and submits the stable target ID.

Older compatible Discovery responses without relation lookup metadata retain the raw-ID field behavior. The adapter never guesses record labels from conventional fields such as name, title or summary.

The current n8n UI loads bounded relation options when the relevant field is configured. Very large target sets should use expressions with stable IDs until n8n exposes a searchable dynamic relation option surface that can consume LifeSpace’s paginated/searchable lookup directly.

At execution time Create uses the already-configured Record Type selector and sends the canonical mutation directly. This avoids paying a current-principal inventory round trip merely to rediscover whether adapter-side semantic preflight would improve an error message. Core remains the final authority for schema, Capability, Policy and authorization checks.

Update and Delete

LifeSpace uses optimistic concurrency.

By default the node reads the current Record version immediately before Update/Delete when executing per item and sends that version with the mutation. This keeps the ordinary n8n UI free from mandatory internal version entry while preserving stale-write protection for the actual mutation race.

When Batch Processing is enabled and no explicit version is configured, Core resolves current versions set-wise as part of Bulk/Batch preparation rather than forcing one HTTP pre-read per item.

Update does not add a Runtime Discovery request before the mutation. Core validates Calendar and other Capability semantics against the resulting mutation.

If a workflow intentionally needs to bind a known version, add Options → Version.

List / Query

List / Query exposes the single LifeSpace Canonical Query model:

• optional Search over fields published as searchable;
• Filter Groups, where each group chooses Match All / Match Any and groups compose with AND;
• Discovery-backed Field and Operator selectors plus string/expression Value controls that are parsed back to canonical typed values;
• ordered Sorts generated from canonical sortable fields;
• optional Viewing Timezone context when sorting a temporal_range field;
• Return All, Limit, and an optional opaque Cursor.

The node sends one structured POST .../records/query request per page. Core remains responsible for final contract validation, timezone/DST conversion, authorization, null-last ordering and cursor identity. Stored workflows using previous query controls remain execution-compatible through hidden adapter fallbacks.

New configurations do not expose Standard Query or Capability Query. Stored workflows that explicitly selected the previous Capability Query remain executable through a hidden compatibility path.

Execute Action

Choose an Action from Runtime Discovery while authoring the workflow. The selected Action’s semantic input and concurrency metadata are pinned into the workflow configuration.

Action Input contains only semantic/domain inputs. LifeSpace concurrency metadata is not rendered as a business field. For the current record-version contract, execution reads the current Record version immediately before the Action and sends it using the transport declared by the saved Action contract.

Execute Action performs zero Runtime Discovery requests. Human Action Input still uses the same Discovery-driven field-type projection as Create/Update, including instant, fixed Range values and temporal_range. The saved Action contract is execution metadata only, not authorization proof; Core rechecks current Action authority on every invocation. Workflows saved before this contract pinning change must reselect the Action once and save before they can execute it.

This means actions such as complete / reopen no longer ask users to type an internal version value.

Semantic Relations / 语义关系（Service Workflow）

Use LifeSpace → Resource: Semantic Relation to manage directed, independently stored edges between existing LifeSpace records. This is a first-class UI for the Core Semantic Relations contract, not a new Record field type.

• Create: Select Space, set Source Model Key / Source Record ID, the registered Predicate (such as relates_to), and Target Model Key / Target Record ID. The source Model Definition must declare semanticRelations.outgoing for that predicate. Duplicate creation is idempotent according to Core.
• Get: Supply rel_* ID, optionally hydrate the source, target, or both currently visible records.
• List: Filter by Source Model Key + Source Record ID and/or Target Model Key + Target Record ID, with an optional Predicate. Target filters enable reverse browsing, but do not reverse the edge direction. Optional hydration returns visible endpoint labels/records. Both identifiers for each selected endpoint must be supplied together.
• Delete: Supply rel_* ID. Deletes only the edge; source and target records remain untouched.

List pagination: With Return All = off, the node returns one n8n item containing {items, nextCursor}, preserving the opaque cursor even for empty pages; feed nextCursor to a subsequent List call. With Return All = on, it follows server cursors and outputs each relation as its own n8n item. Auto-pagination is capped at 100 pages (100 items per request); narrow the filters for larger data sets.

For example, link an Activity record (activity / rec...) to a Task (task / rec...) using relatesto. To read related tasks, List with Source Model Key = activity, Source Record ID = its rec* ID, Predicate = relates_to, Hydrate = Target. To find Activities that point at a Task, List using Target Model Key = task and its record ID.

Core enforces source-write/target-read authority for mutations and both endpoints’ current read authority for reads, including Space, Model Policy and current credentials. The Workflow node uses only the configured LifeSpace Service API credential and never elevates authority or caches/hides these checks. Edge records do not appear in ordinary Record Get payloads. Fixed model references (record/record_list) are a separate mechanism.

This resource consumes the currently published Core Semantic Relations API. An older Core deployment without these endpoints returns its normal HTTP error; it is not silently converted to a Record relation. The npm package must be built/published and installed in n8n before this UI appears.

Advanced API Request

The API Request resource is an escape hatch for LifeSpace routes that do not yet have dedicated node UX.

Paths are relative to the configured API Base URL, for example:

/me/_discovery/inventory

Use normal Record operations when possible because they benefit from Runtime Discovery metadata and n8n-specific UX.

Use the LifeSpace Agent Tool

Use LifeSpace Agent Tool when connecting LifeSpace to an n8n AI Agent. This is a separate native AiTool surface rather than the human workflow node running through usableAsTool.

Attach a LifeSpace Agent API credential. Configure the Tool’s structural scope — Space, Record Type and operation — in the node. Selecting the Record Type loads the current LifeSpace semantic detail and pins the model version, schemaHash, fields/query/action semantics and Space label into the workflow. At runtime the Tool derives its model-facing name, description and input schema from that saved snapshot, so supplyData() performs zero Runtime Discovery requests. Reselect Record Type to refresh the pinned contract after a LifeSpace model change.

Direct Agent calls use the Agent’s own current authority. The Tool schema also accepts delegationId for represented User execution. If direct authority is insufficient and no valid represented delegation was supplied, the Tool returns the exact authorizationRequired scope that can be passed to LifeSpace Request Authorization.

For Canonical Query, the model receives semantic inputs such as:

{
  "search": "food",
  "filters": [
    { "field": "status", "operator": "eq", "value": "pending" },
    { "field": "dueDate", "operator": "gte", "value": "2026-09-13" }
  ],
  "sort": [{ "field": "dueDate", "direction": "asc" }],
  "limit": 20
}

The adapter validates fields and operators against query.canonical and compiles them into the same structured Canonical Filter/Sort/Page request used by the human Workflow node. Local date windows remain explicit typed values; Core owns timezone and DST conversion.

Create/Update schemas are generated from writable model fields. Optional fields that the model does not provide are omitted rather than synthesized as empty values. Actions remain metadata-driven, and adding a future Record Type does not require a model-specific create or query node implementation.

Use LifeSpace Authorization Request nodes

The Authorization Request flow keeps LifeSpace as the authority source of truth across AI, n8n Chat, and deterministic workflow transports.

A typical Agent flow is:

LifeSpace Agent Tool
  -> insufficient direct Agent authority
  -> returns authorizationRequired
LifeSpace Request Authorization
  -> creates/reuses pending arq_*
  -> returns canonical confirmation projection
  -> grants no authority
Human review / trusted workflow decision
  -> Confirm / Deny
Confirm
  -> rechecks current User authority
  -> atomically creates required independent dlg_*
  -> Agent retries business operation with explicit delegationId

For AI-mediated Human Review, the confirmation projection displayed to the user must come from the canonical Authorization Request response and is validated again on confirmation. Deterministic trusted workflow transports may use the arq_* request identity directly according to the LifeSpace contract.

denied means the intended User explicitly rejected the request. cancelled means the requesting Agent/Application no longer needs the pending request. They are intentionally different lifecycle outcomes.

Use the LifeSpace Trigger

The LifeSpace Trigger receives signed LifeSpace Domain Event webhooks.

LifeSpace Eventing separates:

• Webhook Endpoint — reusable callback URL, signing secret and delivery diagnostics for one Space;
• Event Subscription — one Record Type plus selected event types attached to that endpoint.

One Webhook Endpoint can therefore carry events for multiple Record Types through the same n8n callback. In n8n this is represented as one Trigger selecting multiple Record Types; Integration/Eventing still keeps one Event Subscription filter per Record Type.

Trigger setup

1. Add a LifeSpace Trigger node.
2. Attach a LifeSpace Service API credential. The Trigger uses it only for Runtime Discovery and normal LifeSpace API context.
3. Attach a LifeSpace Webhook Signing credential containing the signing secret for this Webhook Endpoint.
4. Choose the Space from Runtime Discovery.
5. Choose one or more Record Types.
6. Choose the required Event Types.
7. Activate the workflow and copy the production webhook URL.
8. In the application/LifeSpace integration management surface, configure one Webhook Endpoint using that URL.
9. Store the endpoint’s one-time signing secret in the Webhook Signing credential.
10. Attach one LifeSpace Event Subscription per selected Record Type to the same endpoint, with matching event-type filters.
11. Use the LifeSpace Webhook Endpoint test operation to verify delivery.

The Trigger verifies X-LifeSpace-Timestamp and X-LifeSpace-Signature with the LifeSpace HMAC-SHA256 contract before emitting workflow data. endpoint.test payloads are always accepted after signature verification.

For ordinary record events, the Trigger preserves the LifeSpace modelKey exactly as delivered and emits the same plain value as recordType for n8n composition. Pass {{$json.recordType}} and {{$json.recordId}} directly to a downstream LifeSpace Record node; it calls the canonical modelKey-addressed Runtime path with zero Discovery.

Webhook Endpoint / Event Subscription creation is intentionally not performed by the n8n Service API Token today because LifeSpace treats that configuration as a Space-management operation. The adapter does not bypass that authority boundary.

What the package provides

• LifeSpace Service API credential for Service Principal authentication and Runtime Discovery using canonical lspsvc tokens, with legacy lsppat accepted only by LifeSpace during migration;
• LifeSpace Agent API credential using one opaque lspagt* secret for direct Agent and represented User/Agent execution;
• LifeSpace Webhook Signing credential for endpoint-scoped inbound HMAC verification;
• LifeSpace human workflow node with Discovery-driven Record operations, default non-atomic Bulk Processing, optional Atomic Consistency, and Advanced API Request;
• LifeSpace Agent Tool native AiTool with Discovery-driven semantic schemas, direct Agent authority, explicit represented-user Delegation selection, and bounded same-model atomic Batch Create;
• LifeSpace Request/Confirm/Deny/Cancel Authorization nodes and Tools for the arq_* user-confirmation lifecycle;
• LifeSpace Trigger with signed multi-Record-Type Domain Event filtering;
• shared thin adapter projection from LifeSpace Runtime Discovery into human n8n controls and model-facing Tool schemas.

The human Record node uses one selected Space and Record Type. With Batch Processing enabled it groups 1-20 incoming items into one LifeSpace request: non-atomic /models/bulk by default, or atomic /models/batch when Atomic Consistency is enabled. It does not emulate Bulk by issuing N HTTP mutation calls.

LifeSpace remains authoritative for validation, authorization, defaults, Mutation Authority, Action semantics, query/time semantics, relation semantics and event contracts. Runtime Discovery and Relation Target Lookup are current capability/reference projections, not execution-authorization proofs.

Architecture boundary

LifeSpace is the source of truth for Identity, Authority, Shared Reality semantics, contracts and Eventing. This repository is an n8n Adapter and must not become a second LifeSpace business-contract implementation.

LifeSpace does not depend on n8n. n8n is one optional orchestration/integration runtime consuming LifeSpace APIs and events.

The human Workflow node and native Agent Tool are separate presentation projections over the same LifeSpace semantics. Shared code in this package only translates Discovery into n8n-specific UI/schema/transport; it does not redefine domain rules.

The adapter does not use privileged model-admin endpoints for ordinary workflow discovery and does not copy Model Definitions into this repository.

Development

Requirements:

• Node.js 22.22.0 or newer;
• npm;
• local n8n for interactive testing.

Validate:

npm install
npm run lint
npm test

npm test builds the package before running adapter contract tests.

Run a local n8n development instance:

npm run dev

Publishing and verification

This repository is public and is intended to remain eligible for n8n Community Node verification.

Publishing is performed by .github/workflows/publish.yml from a version tag matching ..*. npm authentication uses Trusted Publishing through GitHub Actions OIDC and provenance.

Do not publish a verification candidate directly from a developer workstation and do not add a long-lived npm publishing token to the repository.

The package intentionally has no runtime dependencies. It must not read environment variables or the local filesystem. Node UI/help text/errors/README/examples remain English-only for n8n verification compatibility.

Remaining upstream-dependent UX

The adapter now consumes generic person, personlist, record and recordlist reference labels/lookups when LifeSpace advertises them, and uses Calendar Capability bindings rather than model-specific field names. Remaining UX work should be driven by explicit future LifeSpace contract additions or n8n UI limitations; the adapter must not invent missing semantics locally.

License

MIT