rohit/probo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add approval quorum and decision read tools

Browse Source 
Expose document version approval quorums and decisions
through MCP, CLI, and n8n. This lets users inspect who
approved or rejected a document version, including the
rejection comment, without relying solely on the audit
log.

MCP tools: listDocumentVersionApprovalQuorums,
getDocumentVersionApprovalQuorum,
listDocumentVersionApprovalDecisions,
getDocumentVersionApprovalDecision.

CLI commands: document list-approval-quorums,
view-approval-quorum, list-approval-decisions,
view-approval-decision.

n8n operations: Get/Get Many Approval Quorums and
Approval Decisions on the Document resource.

Signed-off-by: Sacha Al Himdani <sacha@getprobo.com>
This commit is contained in:
Sacha Al Himdani
2026-04-20 10:10:39 +02:00
parent 685e9d2e69
commit 5b8918bd5a
14 changed files with 1528 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

119
packages/n8n-node/nodes/Probo/actions/document/getAllApprovalDecisions.operation.ts Normal file
View File

@@ -0,0 +1,119 @@
// Copyright (c) 2025-2026 Probo Inc <hello@getprobo.com>.
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice appear in all copies.
//
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
// REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
// LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
// OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
// PERFORMANCE OF THIS SOFTWARE.
import type { INodeProperties, IExecuteFunctions, INodeExecutionData, IDataObject } from 'n8n-workflow';
import { proboApiRequestAllItems } from '../../GenericFunctions';
export const description: INodeProperties[] = [
{
displayName: 'Approval Quorum ID',
name: 'approvalQuorumId',
type: 'string',
displayOptions: {
show: {
resource: ['document'],
operation: ['getAllApprovalDecisions'],
},
},
default: '',
description: 'The ID of the approval quorum',
required: true,
},
{
displayName: 'Return All',
name: 'returnAll',
type: 'boolean',
displayOptions: {
show: {
resource: ['document'],
operation: ['getAllApprovalDecisions'],
},
},
default: false,
description: 'Whether to return all results or only up to a given limit',
},
{
displayName: 'Limit',
name: 'limit',
type: 'number',
displayOptions: {
show: {
resource: ['document'],
operation: ['getAllApprovalDecisions'],
returnAll: [false],
},
},
typeOptions: {
minValue: 1,
},
default: 50,
description: 'Max number of results to return',
},
];
export async function execute(
this: IExecuteFunctions,
itemIndex: number,
): Promise<INodeExecutionData> {
const approvalQuorumId = this.getNodeParameter('approvalQuorumId', itemIndex) as string;
const returnAll = this.getNodeParameter('returnAll', itemIndex) as boolean;
const limit = this.getNodeParameter('limit', itemIndex, 50) as number;
const query = `
query GetDocumentVersionApprovalDecisions($approvalQuorumId: ID!, $first: Int, $after: CursorKey) {
node(id: $approvalQuorumId) {
... on DocumentVersionApprovalQuorum {
decisions(first: $first, after: $after) {
edges {
node {
id
state
comment
decidedAt
approver {
id
fullName
}
createdAt
updatedAt
}
}
pageInfo {
hasNextPage
endCursor
}
}
}
}
}
`;
const approvalDecisions = await proboApiRequestAllItems.call(
this,
query,
{ approvalQuorumId },
(response) => {
const data = response?.data as IDataObject | undefined;
const node = data?.node as IDataObject | undefined;
return node?.decisions as IDataObject | undefined;
},
returnAll,
limit,
);
return {
json: { approvalDecisions },
pairedItem: { item: itemIndex },
};
}

113
packages/n8n-node/nodes/Probo/actions/document/getAllApprovalQuorums.operation.ts Normal file
View File

@@ -0,0 +1,113 @@
// Copyright (c) 2025-2026 Probo Inc <hello@getprobo.com>.
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice appear in all copies.
//
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
// REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
// LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
// OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
// PERFORMANCE OF THIS SOFTWARE.
import type { INodeProperties, IExecuteFunctions, INodeExecutionData, IDataObject } from 'n8n-workflow';
import { proboApiRequestAllItems } from '../../GenericFunctions';
export const description: INodeProperties[] = [
{
displayName: 'Document Version ID',
name: 'documentVersionId',
type: 'string',
displayOptions: {
show: {
resource: ['document'],
operation: ['getAllApprovalQuorums'],
},
},
default: '',
description: 'The ID of the document version',
required: true,
},
{
displayName: 'Return All',
name: 'returnAll',
type: 'boolean',
displayOptions: {
show: {
resource: ['document'],
operation: ['getAllApprovalQuorums'],
},
},
default: false,
description: 'Whether to return all results or only up to a given limit',
},
{
displayName: 'Limit',
name: 'limit',
type: 'number',
displayOptions: {
show: {
resource: ['document'],
operation: ['getAllApprovalQuorums'],
returnAll: [false],
},
},
typeOptions: {
minValue: 1,
},
default: 50,
description: 'Max number of results to return',
},
];
export async function execute(
this: IExecuteFunctions,
itemIndex: number,
): Promise<INodeExecutionData> {
const documentVersionId = this.getNodeParameter('documentVersionId', itemIndex) as string;
const returnAll = this.getNodeParameter('returnAll', itemIndex) as boolean;
const limit = this.getNodeParameter('limit', itemIndex, 50) as number;
const query = `
query GetDocumentVersionApprovalQuorums($documentVersionId: ID!, $first: Int, $after: CursorKey) {
node(id: $documentVersionId) {
... on DocumentVersion {
approvalQuorums(first: $first, after: $after) {
edges {
node {
id
status
createdAt
updatedAt
}
}
pageInfo {
hasNextPage
endCursor
}
}
}
}
}
`;
const approvalQuorums = await proboApiRequestAllItems.call(
this,
query,
{ documentVersionId },
(response) => {
const data = response?.data as IDataObject | undefined;
const node = data?.node as IDataObject | undefined;
return node?.approvalQuorums as IDataObject | undefined;
},
returnAll,
limit,
);
return {
json: { approvalQuorums },
pairedItem: { item: itemIndex },
};
}

66
packages/n8n-node/nodes/Probo/actions/document/getApprovalDecision.operation.ts Normal file
View File

@@ -0,0 +1,66 @@
// Copyright (c) 2025-2026 Probo Inc <hello@getprobo.com>.
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice appear in all copies.
//
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
// REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
// LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
// OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
// PERFORMANCE OF THIS SOFTWARE.
import type { INodeProperties, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
import { proboApiRequest } from '../../GenericFunctions';
export const description: INodeProperties[] = [
{
displayName: 'Approval Decision ID',
name: 'approvalDecisionId',
type: 'string',
displayOptions: {
show: {
resource: ['document'],
operation: ['getApprovalDecision'],
},
},
default: '',
description: 'The ID of the document version approval decision',
required: true,
},
];
export async function execute(
this: IExecuteFunctions,
itemIndex: number,
): Promise<INodeExecutionData> {
const approvalDecisionId = this.getNodeParameter('approvalDecisionId', itemIndex) as string;
const query = `
query GetDocumentVersionApprovalDecision($approvalDecisionId: ID!) {
node(id: $approvalDecisionId) {
... on DocumentVersionApprovalDecision {
id
state
comment
decidedAt
approver {
id
fullName
}
createdAt
updatedAt
}
}
}
`;
const responseData = await proboApiRequest.call(this, query, { approvalDecisionId });
return {
json: responseData,
pairedItem: { item: itemIndex },
};
}

60
packages/n8n-node/nodes/Probo/actions/document/getApprovalQuorum.operation.ts Normal file
View File

@@ -0,0 +1,60 @@
// Copyright (c) 2025-2026 Probo Inc <hello@getprobo.com>.
//
// Permission to use, copy, modify, and/or distribute this software for any
// purpose with or without fee is hereby granted, provided that the above
// copyright notice and this permission notice appear in all copies.
//
// THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
// REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
// AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
// INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
// LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
// OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
// PERFORMANCE OF THIS SOFTWARE.
import type { INodeProperties, IExecuteFunctions, INodeExecutionData } from 'n8n-workflow';
import { proboApiRequest } from '../../GenericFunctions';
export const description: INodeProperties[] = [
{
displayName: 'Approval Quorum ID',
name: 'approvalQuorumId',
type: 'string',
displayOptions: {
show: {
resource: ['document'],
operation: ['getApprovalQuorum'],
},
},
default: '',
description: 'The ID of the document version approval quorum',
required: true,
},
];
export async function execute(
this: IExecuteFunctions,
itemIndex: number,
): Promise<INodeExecutionData> {
const approvalQuorumId = this.getNodeParameter('approvalQuorumId', itemIndex) as string;
const query = `
query GetDocumentVersionApprovalQuorum($approvalQuorumId: ID!) {
node(id: $approvalQuorumId) {
... on DocumentVersionApprovalQuorum {
id
status
createdAt
updatedAt
}
}
}
`;
const responseData = await proboApiRequest.call(this, query, { approvalQuorumId });
return {
json: responseData,
pairedItem: { item: itemIndex },
};
}

36
packages/n8n-node/nodes/Probo/actions/document/index.ts
View File

@@ -34,6 +34,10 @@ import * as getAllSignaturesOp from './getAllSignatures.operation';
import * as requestSignatureOp from './requestSignature.operation';
import * as cancelSignatureOp from './cancelSignature.operation';
import * as sendSigningNotificationsOp from './sendSigningNotifications.operation';
import * as getApprovalQuorumOp from './getApprovalQuorum.operation';
import * as getAllApprovalQuorumsOp from './getAllApprovalQuorums.operation';
import * as getApprovalDecisionOp from './getApprovalDecision.operation';
import * as getAllApprovalDecisionsOp from './getAllApprovalDecisions.operation';
export const description: INodeProperties[] = [
{
@@ -89,12 +93,36 @@ export const description: INodeProperties[] = [
description: 'Get a document',
action: 'Get a document',
},
{
name: 'Get Approval Decision',
value: 'getApprovalDecision',
description: 'Get an approval decision',
action: 'Get an approval decision',
},
{
name: 'Get Approval Quorum',
value: 'getApprovalQuorum',
description: 'Get an approval quorum',
action: 'Get an approval quorum',
},
{
name: 'Get Many',
value: 'getAll',
description: 'Get many documents',
action: 'Get many documents',
},
{
name: 'Get Many Approval Decisions',
value: 'getAllApprovalDecisions',
description: 'Get many approval decisions for an approval quorum',
action: 'Get many approval decisions',
},
{
name: 'Get Many Approval Quorums',
value: 'getAllApprovalQuorums',
description: 'Get many approval quorums for a document version',
action: 'Get many approval quorums',
},
{
name: 'Get Many Signatures',
value: 'getAllSignatures',
@@ -197,6 +225,10 @@ export const description: INodeProperties[] = [
...requestSignatureOp.description,
...cancelSignatureOp.description,
...sendSigningNotificationsOp.description,
...getApprovalQuorumOp.description,
...getAllApprovalQuorumsOp.description,
...getApprovalDecisionOp.description,
...getAllApprovalDecisionsOp.description,
];
export {
@@ -221,4 +253,8 @@ export {
requestSignatureOp as requestSignature,
cancelSignatureOp as cancelSignature,
sendSigningNotificationsOp as sendSigningNotifications,
getApprovalQuorumOp as getApprovalQuorum,
getAllApprovalQuorumsOp as getAllApprovalQuorums,
getApprovalDecisionOp as getApprovalDecision,
getAllApprovalDecisionsOp as getAllApprovalDecisions,
};